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How to Use This Manual 


This manual is intended as a reference for all Ultimate system users. It 
explains the format and usage of Terminal Control Language (TCL) 
system commands supplied with Ultimate Operating System Revision 
210 series, which includes: 

Revision No. Platforms 

210 Ultimate Bull 6000/7000 and LSI™ systems 

214 Ultimate IB M™ S/370™ and S/390™ systems 

215 Ultimate 1400 systems 

217 Ultimate PLUS™ on Hewlett Packard 9000 systems 

218 Ultimate PLUS on IBM RISC System/6000 systems 

219 Ultimate PLUS on Bull DPX/2 systems 

Note: Some Ultimate system commands work differently on, or are 
not included for, different platforms. For complete information 
on how commands function for a specific platform, please refer 
to the System Administrator Guide /or the platform. 

Readers of this guide should be generally familiar with the Ultimate 
system. New Ultimate users should read the Beginner’s Guide to 
Ultimate and the System Overview before using the TCL system 
commands explained in this guide. 


How the Manual is Organized 

Chapter 1 is an Introduction to System Commands. This chapter 
describes: 

• What TCL is and how to start it. 

• Components of a system command statement. 

• How to enter system command statements. 

• Listing system commands available to your account. 

• Using command stacks and multiple TCL levels. 

• System commands by function. 
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Preface 

Chapter 2 is an alphabetical System Commands Reference. Syntax, 
usage, required access level, and where to find additional information is 
provided for each command. Examples are given for most commands. 

Appendix A contains a glossary. 

Appendix B describes System Messages by message number. 

Appendix C contains a list of ASCII Codes. 

Appendix D contains information on S/370 and S/390 UCSB and FC'B 
Items, which are used with parallel printers on S/370 and S/390 
systems. 

Appendix E contains information on the CAPTURE subroutine. 

Conventions 

This manual presents the syntax for each TC’L system command. In 
presenting and explaining the syntax, the following conventions apply: 

Convention Description 

UPPER CASE Characters or words shown in upper case are 

required and must be entered exactly as shown. 

lower case Characters or words shown in lower case are 

parameters to be supplied by the user, such as 
filename, itemlist, and options. 

(} Braces surrounding a parameter indicate that the 

parameter is optional. 

Enter option : Courier typeface is used for messages and 

prompts displayed by the system. 

bold Boldface type is used for command statement 

components. It also indicates user input. 


XIV 
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RETURN J 


enter 


<key> 


<key-key> 


X'nn' 


The word RETURN, or the RETURN symbol (J), 
means press the RETURN key on the keyboard. 
RETURN is required at the end of a command 
statement in order to begin processing the 
command. 

The word enter means type the required text, then 
press the RETURN key. 

Angle brackets indicate a key other than letters, 
numbers, or punctuation; such as <ESC>. 

Represents a key sequence involving two keys 
held down at the same time, such as <CTRL-X>. 

Defines a hexadecimal number, where 'nn' is the 
hex value; such as X'OB’, X'41', x'FF' 
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1 Introduction to System 
Commands 


Ultimate system commands are entered at the Terminal Control 
Language (TCL) level. TCL is the interface between the user and the 
Ultimate Operating System. 

TCL system commands allow you to perform the following functions: 

• Arithmetic calculations and conversions 

• Invoking the assembler 

• Invoking BASIC 

• Bisynchronous communications 

• Charging for system usage 

• Database backup, restore, and verification 

• Database entry (Ultimate UPDATE® commands) 

• Database query (Ultimate RECALL® commands) 

• Diagnostics 

• Disk drive operation and control 

• Document creation and maintenance 

• Error reporting and recovery 

• File and account creation and maintenance 

• File reallocation 

• Graphing (UltiPlot® commands) 

• IBM-specific commands 

• Indexing 

• Item and list handling 

• Kernel commands 

• Level pushing 

• Listing utilities 
» Logging on/off 

• Print spooler operation and control 

• PROC 

• S tacki ng TCL command s 

• System security 
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• System starting and stopping 

• System upgrading 

• System utilities 

• Tape drive operation and control 

• Terminal and line operation and control 

Note: A list of TCL system commands by function starts on page 
1-14. 


Starting or Getting to TCL 

By default, most Ultimate systems are set up to run TCL as soon as you 
log on. Once you enter your accountname and password (if necessary), 
you should see the TCL colon (:) prompt, or the greater-than sign (>) if 
the TCL stack is OFF. The TCL prompt can be changed with the TCL- 
PROMPT command. 

If, instead of TCL, your account is set up to start a program or display a 
menu, check with your system manager on how to access TCL. 
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Components of a System Command Statement 

TCL system command statements consist of the following components: 

COMMAND {parameterl ...parameter/!} j 


COMMAND All statements contain a COMMAND. COMMANDS must be entered 

exactly as defined in the system Master Dictionary (MD); generally they 
are defined with uppercase letters. 

A COMMAND can be a verb (written in assembly language), a PROC 
(written in PROC language), or a catalogued BASIC program. 
Commands must exist in a user account's MD. 


PARAMETER Statements can also contain one or more parameters, although many 
commands do not require any. Parameters are user-specified 
information such as filenames, item-lDs, or options. 

Other things to know about parameters: 

• There must be at least one space between a COMMAND and a 
parameter. 

• Parameters in this manual shown enclosed in braces {) are optional. 

• Parameters must be separated from each other with spaces or 
commas. To avoid errors, be sure to check the exact syntax before 
entering a command statement. 

« Some parameters must be enclosed in: 

(parentheses) 

"double quotes" 

'single quotes' 

To avoid errors, be sure to check the exact syntax before entering a 
command statement. 


RETURN 


You must press RETURN (J) to begin execution of a command. 
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More on 


Filenames 


Parameters 

The most frequently used parameters include filenames, positional 
parameters, keyword parameters, and options. 


Many TCL commands act on files. Each Ultimate file contains a 
DICTIONARY section, and can contain one or more DATA sections. 
For example, the BP file below has a single dictionary section and three 
associated data sections: 

dict Section Associated data Sections 

a) bp b) bp 

e) BP2 
d) BP3 


A filename can be specified in different ways, depending on the section 
of the file to be used: 


% dataname 


dictname,dataname 


DICT dictname 


DICT dictname,dataname 

data dataname 


DATA dictname,dataname 


Specifies the DATA section of a file with 
the same name as its DICT. For 
example, BP shown in b) above. 

Specifies a DATA section when the 
dictname has multiple DATA sections. 
For example: BP,BP shown in b) above; 
BP,BP2 shown in c) above; or BP,BP3 
shown in d) above. 

Specifies the DICT section of a file. For 
example, DICT BP shown in a) above. 

Specifies the DICT section of a file. 
Same as DICT dictname above. 

Specifies the DATA section of a file with 
the same name as its DICT. Same as 
dataname above. 

Specifies a DATA section when the 
dictname has multiple DATA sections. 
Same as dictname,dataname above. 
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Positional 

Parameters 


Keyword 

Parameters 
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Some TCL commands require that their parameters be entered in a certain 
order. These are known as positional parameters. For example, the 
SET-STACK command requires that you enter its parameters as follows: 

SET-STACK n,status,sents,clear,one.sent 

In other words, SET-STACK expects that the first parameter will be the 
line number, the second parameter will be the status, and so forth. 

To avoid typing in values for all parameters when you only want to 
change one, you can use commas to specify parameter default values. 
For example, if the only SET-STACK parameter you want to change is 
sents (the number of commands saved in your stack) from the default 
of 32 to the maximum of 120, you could enter: 

SET-STACK ,, 1 20 

The commas represent the current values for line number and status. 


Some TCL commands have keyword parameters as an alternative to 
positional parameters. Keyword parameters contain the parameter name 
(the keyword), an equal sign, and the parameter value. Unlike 
positional parameters, keyword parameters can be entered anywhere in 
the statement. For example, the parameters for the SET-STACK 
command can be entered in either positional or keyword syntax: 

POSITIONAL SYNTAX: 

SET-STACK 2,ON, 120,NO,N 0 

KEYWORD SYNTAX: 

SET-STACK STATLS=ON l»ORT=2 CLEAR=NO SENTS=20 ONE.SENT=NO 

Other things to know about keyword parameters: 

• Keywords must be separated from each other with spaces or 
commas. 

• Keywords can be abbreviated to at least three characters, or more in 
order to be unique among other keywords in the command. 
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Options 


» Zero or more spaces can both precede and follow the equal sign in 
the keyword parameter. 

• Multiple keyword values must be enclosed in parentheses. Within 
the parentheses, separate multiple keyword values from each other 
by one or more spaces, or by a comma. 


Option parameters are one-letter codes that perform additional actions 
during the command. 

Note: Option parameters must always be specified at the end of the 

command. 

Most options must be preceded by a left parenthesis, with the right 
parenthesis optional. To avoid errors, be sure to check the exact syntax 
before entering an option. 

If multiple options are selected, they can be entered with no separation 
between them, or they can be separated from each other with spaces or 
commas. For example: 

LIST-LOCKS (IP 
or 

LIST-LOCKS (I P 
or 

LIST-LOCKS (I,P 

In this example, the I option specifies that item lock information be 
included in the lock list, and the P option specifies that the lock report be 
sent to the printer instead of displayed on the screen. 
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Entering and Editing System Command Statements 

System command statements can be entered when your cursor is at the 
TCL prompt. 

To enter a command statement, type the COMMAND (usually in 
uppercase), followed by any parameters (in upper or lowercase), and a 
RETURN. For example: 

LI ST-IT EM C U STO M E R S J 

where LIST-ITEM is the command, CUSTOMERS is a filename 
parameter, and J means press the RETURN key to execute the 
statement. The LIST-ITEM command lists all items in the CUSTOMERS 
file. 

To correct a command statement, use the <BACKSPACE> key or 
<CTRL-H> to erase the mistake, then retype the entry. Other helpful 
editing key sequences can be found in the section later in this chapter on 
Using Command Stacks. 

Commands that are too long to fit on a single line will wrap to the next 
line if your terminal is set up to do so. 

When the command finishes execution, the screen returns to the TCL 
prompt. 

An error message is displayed if the command is improperly formatted, 
is not in your Master Dictionary, cannot be processed for some reason, 
or if an error occurs during processing. A description of system 
messages is provided in Appendix B. 
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Checking the Commands Available in Your Account 

Most TCL system commands are standard and available on all user 
accounts. However, some TCL commands apply only to certain 
machine types or to optional software, and may not be available on your 
system. (For complete information the commands available for a 
specific platform, please refer to the System Administrator Guide for the 
platform.) 

In addition, some commands must be executed from the system 
manager’s SYSPROG account, or from the SECURITY account. 

Every command that can be executed from your account is an item in 
your Master Dictionary (MD). Use one of the following to see the 
commands in your account: 

Command Result 

LISTVERBS Lists command names (other than PROCs) 

LISTPROCS MD Lists PROCs 


Types of Commands 

Commands that do not access a file are known as TCL-I commands. 
Examples of this type of command include: 

LOGTO accountname 
MESSAGE line.no message-text 
OFF 

SP-ASSIGN {(options) 

TIME 

Commands of a specific form that access a file and its items are known 
as TCL-II commands. Examples include: 

COPY filename itemlist {(options) 

ED filename itemlist {(options) 

TCL-II commands require that an itemlist be entered if no select-list is 
present. Also, TCL-II commands do not require single quote marks 
around item-lDs. 
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Commands that access a specified file and, optionally, its items and 
offer a choice to use selection criteria and to specify output format are 
known as Ultimate RECALL commands. An example of an Ultimate 
RECALL command is: 

LIST filename {itemlist} {selection-criteria} {output-specs} 
{(options} 

If no itemlist is specified in an Ultimate RECALL command statement, all 
items in the file are assumed. If an item-lD is specified, it must be 
enclosed in single quotes, double quotes, or backslashes. 

Using Command Stacks 

As each command statement is entered at TCL, it is placed in the TCL 
command stack if the stack is set to ON. Command statements in the stack 
can be displayed, edited, and re-executed during the session. The TCL stack 
is available on all terminals supported by Ultimate except the IBM 3270 
terminal. (However, see the R option of the 3270.PFK command.) 

The default TCL stack settings are: 

Stack: ON 

Stack Limit: 32 commands 

Clear at Logoff: YES 

One copy of sentence: NO 

To change any setting, use the SET-STACK command. 

Note: If the stack is turned off, the default TCL prompt character is a 

greater-than sign (>) instead of a colon (:). 

Stack The following commands are used with the TCL stack: 

Commands 

. (period) View the stack. Same as VIEW. 

CLEAR-STACK Clears the stack. 

SET-STACK Changes or displays default stack settings. 

VIEW View the stack. Same as . (period). 

Refer to Chapter 2 for complete information on stack commands. 


Default 

Stack 

Settings 
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Each line has its own stack. The TCL stack is a First In First Out (FIFO) 
stack, where new TCL commands are added to the top of the stack, and 
the oldest entry is discarded from the bottom when the stack is full. For 
example, the following displays a stack set to a maximum of 32 
commands: 



001 BASIC BP CUSTOMER.MAINT 
002 ED BP CUSTOMER.MAINT 
003 WHO 

004 SORT INVENTORY BY DESC DESC UOM 


031 LISTFILES 
032 LOGTO DEV 


Enter the RUN command: 

RUN BP CUSTOMER.MAINTJ 
Stack after entry of the RUN command: 


v_y 


001 RUN BP CUSTOMER.MAINT 
002 BASIC BP CUSTOMER.MAINT 
003 ED BP CUSTOMER.MAINT 
004 WHO 

005 SORT INVENTORY BY DESC DESC UOM 


032 LISTFILES 


Notice that LOGTO DEV was at entry 032 before RUN was executed, but 
dropped off the stack after RUN was executed. 

The last command statement executed (in this case, RUN) is always 
placed into entry 001. However, if entry 001 is re-executed without an 
intervening command, its second execution is not duplicated onto the 
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Displaying 

Stack 

Entries 


stack. You can also set the one sentence parameter so that only the last 
entry of a statement is kept in the stack. 

By default, the stack is cleared when you log off, although this can be 
changed with SET-STACK. The stack is not saved by the file-save 
process, so it is cleared at every file-restore. 

Stacked TCL commands are displayed, edited, and executed via the stack 
command keys: 

Use the following keys to display the stack contents: 


. (period) or VIEW 
. n or VIEW n 
. n-m or VIEW n-m 
. aaa or view aaa 


Display the entire stack. 

Display statement n. 

Display statement n-m. 

Search for and display the first statement 
starting with aaa. 


Note: The stack display commands .(period) and VIEW are never added 
to the stack. 


T Displays the last TCL command statement 

entered, with the cursor at the end of the 
statement. Continued use of this key 
displays statements from newer to older. 

si After another stack display command has 

been entered, use of this key displays 
statements from older to newer. 

<F4 > Search or <S/0> key. <F4> searches the 

stack for an entry beginning with the 
characters currently typed at the TCL 
prompt. When a match is found, the 
entire statement is displayed. To search 
for the next occurrence, press <F4> 
again. If no characters were typed at the 
TCL prompt before <f 4> was pressed, 
the entire stack is displayed. 
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Use the following keys to edit and re-execute stack commands: 

—» Moves the cursor one character to the right 

until the end of the statement is reached. 

On terminals on which this key is different 
from the BACKSPACE key, moves the 
cursor one character to the left until the 
beginning of the statement is reached. 

<HOME> Moves the cursor to the beginning of the 

statement. 

<TAB> Moves the cursor one word to the right 

until the end of the statement is reached. 

<F1> or <CTRL-E> <EDIT> key. <F1> or <CTRL-E> toggles 

between INSERT and REPLACE edit 
modes. The initial mode is REPLACE. 

<BACKSPACE> Deletes the character to the left of the cursor 

until the beginning of the statement is 
reached. 

<DEL> Deletes the character at the cursor. 

<CTRL-R> Reprints the current TCL command up to 

the current cursor position. 

<CTRL-W> Erases one word to the left. 

<CTRL-X> Clears the current TCL command, places 

the cursor next to the prompt character, 
and returns to REPLACE mode. The 
current stack position is not changed. 

< S HI FT - F1 > Help key. <SHIFT-F1> displays a help screen 

of the stack manipulation, cursor movement, 
and editing keys described above. 

RETURN Executes the displayed TCL command. 


Editing 

Stack 

Entries 
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TCL Level Pushing 

Level pushing allows you to suspend activity in the current TCL session 
(level) and start an additional, completely separate TCL session without 
logging off. The information for the session at each level is saved and is 
restored when you return to that level. When you return to a previous 
TCL level (also known as level popping), the screen is updated so that it 
looks just as it did before the push. 

Level pushing is available any time input is expected by TCL, BASIC, 
Ultimate RECALL, Ultimate UPDATE, or PROC. The number of available 
levels is limited only by disk space. The number of TCL levels for the 
current process is indicated as follows: 

• If the status of both the TCL stack and TCL-PROMPT is ON, the level is 
indicated only if the L code is included as part of the TCL-PROMPT 
command. 

• If the status of the TCL stack is ON, but the status of TCL-PROMPT is 
OFF, a colon prompt (:) is displayed for each level. For example, if 
you have three TCL sessions active, the following prompt is displayed: 


• If the status of both the TCL stack and TCL-PROMPT is OFF, and if more 
than one level is active, two greater-than signs are displayed. For 
example, if you have three TCL sessions active, the following prompt is 
displayed: 

> > 


TCL level pushing uses the following commands: 


LEVEL-EXIT Returns (pops) you to the previous TCL level after a 

level push, or, if specified, to the bottom level. 

SET-LEVEL-PUSH Activates or deactivates TCL level pushing. Also 

lets you designate function keys for push, pop, and 
screen refresh operations; set the output buffer size; 
and specify a startup command to execute at each 
level push. 


SHOW-LEVELS Displays TCL level information for a specified line. 
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System Commands By Function 

The following pages list the Ultimate System Commands by function. 
Commands followed by a single asterisk (*) were introduced in 
Revision 200; those followed by a double asterisk (**) were introduced 
in Revision 210. 


Arithmetic Calculations & 

Conversions 

ADDD 

MULX 

ADDX 

PRIME 

DIVD 

RTD 

DIVX 

SUBD 

DTR 

SUBX 

DTX 

XTD 

MULD 


Assembler 


:DEBUG-PSYM 

OPT 

AS 

SET-SYM 

ASM 

STRIP-SOURCE 

CROSS-INDEX 

VERIFY-SYSTEM 

MUST 

X-REF 

MLOAD 

XREF 

MVERIFY 


BASIC 


BASIC 

DECATALOG 

CATALOG 

EBASIC 

CLEAR-BASIC-LOCKS 

LIST-NAMED-COMMON* 

CLEAR-NAMED-COMMON 

RUN 

COMPILE 



Bisynchronous Communications 


_C- 

:RESTART-BSC 

CHANGE-BSC-TIMER 

B-ATT 

DISCONNECT 

B-DET 

RECEIVE 

B-LIST 

TRANSMIT 


BSC-DIAL 
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Charging System Usage 


CHARGE-TO 

CLEAR-ACC-FILE 

CHARGE-UNITS** 

CHARGES 

LISTACC 

Database Backup, Restore, and Verification 

:FILELOAD 

LOG 

ACCOUNT-RESTORE 

LOG-STATUS 

ACCOUNT-SAVE 

LOGGER 

ALL-UPDATE-SAVE 

PART-UPDATE-SAVE 

FILE-SAVE 

RESTORE-FILE** 

FILEOPT 

SAVE 

LIST-FILE-STATS 

SEL-RESTORE 

LIST-VSAVE-STATS* 

LOAD-STATS 

VERIFY-SAVE* 

Database Entry: Ultimate 

update Commands 

LIST-UERRORS 

UPD-VALIDATE 

LIST-UITEMS 

UPDATE 

UPD-DEF 

USORT 

Database Query: Ultimate 

recall Commands 

CHECK-SUM 

SORT 

COUNT 

SORT-ITEM 

LIST 

SORT-LABEL 

LIST-ITEM 

SREFORMAT 

LIST-LABEL 

SSELECT 

REFORMAT 

STAT 

SELECT 

SUM 


Diagnostics 


_a*- 

DISK.DIAGS 

PRINTER.DIAGS 

MEM.DIAGS 

TAPE.DIAGS 

ON-LINE-DIAGS 
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Disk Drive Operation 

and Control 

o 

DISK-ADDRESS** 

DISK-FORMAT** 

DISK-RESYNC** 

DISK-STATUS** 

DISK.COPY 

START-RESYNC** 


Document Creation & Maintenance 


RUNOFF 

WP-IN(PUT) 

WP-OUT(PUT) 


Error Reporting and 

Recovery 


:INIT-SYSTEM 

CLAIM 

DUMP 

FIX-FILE-ERRORS 

LIST-GFE 

LIST-LOCKS 

LIST-SYSTEM-ERRORS 

PR1NT-ERR 

SYSTEM-ERROR-SUMMARY 

SYSTEMERRORS 


File and Account Creation and Maintenance 


BMSH 

CLEAR-FILE 

CREATE-ACCOUNT 

CREATE-FILE 

DELETE-ACCOUNT 

DELETE-FILE 

GROUP 

HASH-TEST 

I ST AT 

ITEM 

MOVE-FILE** 

RENAME-ACCOUNT 

RENAME-FILE 

UPDATE-ACCOUNT 

UPDATE-FILE 


File Reallocation 




REALLOCATE 


Graphing: UltiPlot Commands 

LIST-PLOT-DEVICES SPIE 

PIE SPLOT 

PLOT 
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IBM-Specific Commands 


#CP 

RP-PUNCH 

3270.PFK** 

RP-READ 

ACCESS-CODE 

S/1-DUMP 

RP-ATT 

S/1-LOAD 

RP-DET 

SYSMON** 


Indexing 

CLEAR-INDEX-LOCKS* 

LIST-INDEX-LOCKS* 

CREATE-INDEX* 

LIST-INDEXES* 

DELETE-INDEX * 



Item Handling 

COMPARE 

ED{IT) 

COPY 

EEDIT 

COPY-FILES 

EXCHANGE 

CT 

RECOVER-FD 

DELETE 

SE** 

ECOPY 

SEARCH 


Kernel Commands 

:TRAP 

SLEEP 

:UNTRAP 

UNLOCK-FRAME 

LOCK-FRAME 



Level Pushing 


LEVEL-EXIT** 

SHOW-LEVELS** 

SET-LEVEL-PUSH** 



List Handling 


-- 

COPY-LIST 

GET-LIST 

DELETE-LIST 

QS ELECT 

EDIT-LIST 

SAVE-LIST 
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Listing Utilities 


LISTCONN 

LISTPROCS 

LISTDICT 

LISTUfSERS) 

LISTF 

LISTVERBS 

LISTFILES 



Logging On/Off 


:RESTARTLINE 

LOGTO 

:SET-MAX-LINES 

OFF 

COFF 

RESET-LOGOFF 

LOGOFF 

SET-LOGOFF 

LOGON 


Network 


IMT-NET 


Print Spooler Operation and Control 


LA 100 

SP-LISTASSIGN 

PRINTER 

SP-LISTLPTR 

PRINTRON1X 

SP-LISTQ 

SET-LPTR 

SP-MENU 

SP-ASSIGN 

SP-OPEN 

SP-CLOSE 

SP-SKIP 

SP-DELETELPTR 

SP-STARTLPTR 

SP-DEQ 

SP-STATUS 

SP-EDIT 

SP-STOPLPTR 

SP-KILL 

SP-TAPEOUT 


PROC 


BUILD-PROC** 

RUNPROC 


Stacking TCL Commands 


. (period) 

SET-STACK 

CLEAR-STACK 

VIEW 




1-18 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


6985-3.2 




Introduction to System Commands 


System Security 


ACCESS-MAINT 

System Starting and 

Stopping 

:WARMSTART 

CREATE-BOOT 

:WARMSTOP 

USER-COLD-START 

COLDSTART 

WARMSTART 

System Upgrading 


ALL-ACCOUNT-RESTORE 

SYS-GEN 


System Utilities 


:TASKIN1T 

SET-LANGUAGE* 

BLOCK-PRINT 

SET-TIME 

DATE 

STATUS 

LINK-WS 

TIME 

LOOP-ON 

ULTPMENU 

POVF 

ULTIKIT 

REV 

WHAT 

SET-DATE 

WHERE 

SET-FILE 

WHO 

Tape Drive Operation and 

Control 

S-DUMP 

T-LOAD 

T-ATT 

T-RDLBL 

T-BCK 

T-READ 

T-CHK 

T-RET 

T-COPY 

T-REW 

T-DET 

T-SPACE 

T-DUMP 

T-STATUS 

T-EOD 

T-UNLOAD 

T-ERASE 

T-WEOF 

T-FWD 

T-WTLBL 
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Terminal and Line Operation and Control 


132 & 80 

BREAK-CHR-OFF 

BREAK-CHR-ON 

BREAK-KEY-OFF 

BREAK-KEY-ON 

DROP-DTR 

DROP-RTS 

ECHO-OFF 

ECHO-ON 

LOAD-TERM DEF 

MESSAGE 

MSG 

P 

PAGEIO-OFF 

PAGEIO-ON 

PASSTHRU 

RAISE-DTR 

RAISE-RTS 

READ-STATUS 

SAVE-PARITY 

SET-BAUD 


SET-TERM 

SMARTERM 

STRIP-PARITY 

TABS 

TCL-PROMPT** 

TCL-PROMPT-OFF** 

TERM 

TERM-INIT 

TERM-VIEW* 

TERM-VIEW-OFF* 

TERM-VIEW-ON* 

TERMINAL 

TRANSLATE-INPUT* 

TRANSLATE-LOAD* 

TRANSLATE-OFF* 

TRANSLATE-ON* 

TYPEAHEAD-OFF 

TYPEAHEAD-ON 

WY60 

X-OFF 

X-ON 
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System Support Commands 

The following commands should only be used by System Support 
personnel, or by VTERM users, and are not described in this manual: 

•.STARTSYSTEM 
:STARTVTERM 
CLEAR-VTERM-LOCKS 
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Notes 
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2 System Commands Reference 


COMMAND 


Syntax 


Description 


Available On 


See Also 


This chapter is an alphabetical reference of TCL system commands. 
The following information is provided for each command: 


NAME 

A brief description of the command's function is displayed below its 
name. 


COMMAND {parameter} {(options) Shows the exact syntax of the 

command statement in 
boldface type. Braces 
indicate an optional parameter. 


parameter Each parameter is shown in boldface type, with an 
explanation to the right. 


(options 

A 

B 


One-letter options are shown indented below any 
parameters. For example: 

Option 1 

Option 2 


A detailed description of the command's usage is displayed here. A 
boxed example is often provided at the end of this section: 


:COMMAND parameter (optionJ 


If necessary, an 
explanation of the example 
is provided here. 


Lists default accounts on which the command is available, required 
privilege level if greater than zero, and any platform limitations. 


Lists associated commands, as well as other documents containing more 
information about the command. 
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#CP 


#CP 

Syntax 

Description 


Available On 
See Also 




#CP (Control Program) executes CP commands on an Ultimate S/370 
and S/390 virtual machine. 


#CP command 

command Specifies any supported CP command. 


Use #CP to invoke the CP facility of VM; for example, to perform a 
virtual reader/punch or other CP function. 

Note: The following CP commands are not supported via #CP: 

DCP LOGOUT SHUTDOWN 

DEFINE LOGOFF STCP 

IPL SET SYSTEM 

In addition, other commands may not be supported, depending 
on your installations security arrangements within VM. 

Ultimate displays up to 2000 or 4000 characters of returned 
information, depending on the Ultimate S/370 and S/390 hardware. 
Responses exceeding this maximum are truncated and the excess 
character count is displayed. VM error message numbers are returned 
when appropriate. 


: #cp attach 181 to ultimate as F 80 J Attaches tape 

drive. 

TAPE 181 ATTACHED TO ULTIMATE AS F80 

: #cp query virtual urj Checks device 

settings. 

RDR 0040 CL 0 NOCONT NOHOLD EOF READY 
RDR 0040 2540 CLOSED NOKEEP 


SYSPROG or SECURITY account on Ultimate S/370 and S/390 systems. 

Virtual Machine/System Product, CP Command Reference Manual for 
the release and type of VM at your site (available from IBM.) 
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%SP-KILL 


%SP-KILL 

Syntax 


Description 

Available On 
See Also 

6985-3.2 


%SP-KILL is used by the SP-DELETELPTR, SP-DEQ, and SP-KILL 
commands to, respectively, delete a printer from the system, dequeue a 
print job from a forms queue, or terminate printer output. 


% SP-KILL {(options} 

(options: 

n Terminates output on printer n. You must have level 2 

privileges to terminate output on a printer other than the 
one on which you currently have a job printing. 

A Terminates all output produced on the user’s account. 

Dn Deletes printer n from the system. You must have level 

2 privileges to use this option. 

Fn Dequeues print job n and turns it into a hold file. You 

must have level 2 privileges to dequeue a print job other 
than your own. 

F A Dequeues all jobs produced on the user’s account. 

FB Dequeues all jobs. You must have level 2 privileges to 

use this option; otherwise it dequeues only your jobs 

F U Same as FB, except an error message is displayed if you 

do not have level 2 privileges. 

Note: If no option is entered, %SP-KILL attempts to terminate output 
on printer 0 (zero). 


%SP-KILL is not normally used. Instead, use the SP-DELETELPTR, 
SP-DEQ, or SP-KILL commands, which allow only the options 
appropriate to their function. 


Any user account. 


SP-DELETELPTR 

SP-DEQ 

SP-KILL 
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%SP-LISTQ 

Syntax 


Description 

Available On 

See Also 

2-4 


%SP-LISTQ is used by the SP-LISTQ command to list queued print jobs. 


% SP-LISTQ {(options) 

(options: 

n Lists print job entry number n. 

A Lists print jobs created by the current account. 

C Suppresses listing of status information; only 

displays the total number of print jobs and their total 
amount of disk space used. 

E Replaces status information with current position and 

beginning frame ID (FID) of hold file. 

F Outputs a list of queued print jobs in job queue 

number order (Form# on the SP-ASSIGN listing). For 
example, lists all queued print jobs and their status in 
job queue 0, then jobs in job queue 1, etc. 

P Routes output to the spooler. 

'account' Lists print jobs created by 'account'. 

Note: Options that follow 'account' are ignored. 

Note: If parameters are omitted, all print jobs are listed. 


Options for the %SP-LISTQ command are the same as the SP-LISTQ 
command, except %SP-LISTQ uses F instead of Q to specify the output 
form queue. For more information, see the SP-LISTQ command. 


Any user account. 


SP-LISTQ 
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%SP-STARTLPTR 


%SP-STARTLPTR 

%SP-STARTLPTR is a synonym for the SP-STARTLPTR command. Refer 
to the SP-STARTLPTR command for complete information. 
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. (period) 


. (period) 


Syntax 


Description 


The . (period) command retrieves current entries from the TCL stack. 
The . command is a synonym for the VIEW command. 


. {n} {n-m} {string} {(P> 

n Specifies the stack entry number containing the 

command to be viewed. If omitted, the entire stack is 
displayed. 

n-m Specifies a range of stack entry numbers containing the 

commands to be viewed. If omitted, the entire stack is 
displayed. 

string Specifies a character string that matches the beginning 

character string of a command to be viewed. The string 
can include the Editor wild card character ( A ). 

Note: Either n, n-m, or string may he specified, hut not a 
combination. 

(P Routes output to the spooler. 

Note: If parameters are omitted, the entire stack is displayed. 


Use . to display TCL commands previously executed on your line. 

For complete information on viewing the TCL stack, please refer to the 
section "Using Command Stacks" in Chapter 1 of this document. 
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(period) 


Available 

See Also 


: . J 

Seq Sentence 
001 WHO 

002 WP-OUT WP-DOCUMENTS,PAYROLL DOC.1 (P 
003 LIST ONLY WP-DOCUMENTS 
004 LISTUSERS 

005 ED BP CUSTOMER.MAINTENANCE 
006 LISTFILES 

: . wj Search for the first occurrence of 

: who a command starting with W. 


On Any user account. 


CLEAR-STACK 

SET-STACK 

VIEW 

Chapter 1 of this document for further information on the TCL stack. 
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132 and 80 


132 and 80 

Syntax 

Description 


Available On 

See Also 


The 132 command and the 80 command change the terminal setting to 
132-column or 80-column mode, respectively. 


132 

80 


132 displays information on the screen in 132-column format. It 
reduces the size of the characters, allowing more characters across the 
screen. 

80 displays information on the screen in 80-column format. It expands 
the size of the characters, allowing fewer characters across the screen. 

Note: 132 and 80 commands work only on terminals that support 
changes in the number of characters displayed per line. 

These commands also change the WIDTH parameter of the TERM 
command. 132 changes the width to 131; 80 changes the width to 79. 


: 132 J All characters are displayed in 132-column format. 

: 8 0 J All characters are displayed in 80-column format. 


Any user account. 


TERM 
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3270. PFK 


3270.PFK 


Syntax 


6985-3.2 


3270.PFK defines PF keys on IBM 3270 terminals. 


3270 . PFK n action {data} 

3270 . PFK CL 

n Specifies the number of PF key to be defined, from 1-24. 

action Specifies the action to define on a key. Actions can 

include: 

A Appends data and <CR> to the current line; current input 

line is not cleared and data is not echoed on screen. 

B Defines key as <BREAK> key. 

C Defines key as <CLEAR> key. 

D Deletes current line and replaces with data. The user 

must press ENTER to execute the line. 

I Ignores current line and replaces with data and <CR>; 

current input line and next line are cleared and data is 
echoed on screen. 

R Defines key as RETRIEVE key. This lets you retrieve up 

to the last 32 inputs made at the terminal, including TCL 
commands, BASIC input, editor commands, and all other 
input. As the key is pressed, each preceding input is 
displayed, and can be executed by pressing ENTER. 

data Specifies a string of up to 28 ASCII characters to be 

entered at the current cursor location when the key is 
pressed. Data must be entered for A, D, and I actions. If 
the D option is used, ASCII characters are replaced with 
EBCDIC characters. Any data following a B, C, or R 
action is ignored. 

CL Clears all previous definitions and resets all keys to 

system default values. 
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Description 


Available On 


2-10 


3270.PFK allows the 3270 PF keys to be customized. Once a key has 
been defined, it executes that definition each time it is pressed. The 
definition remains until it is changed by another 3270.PFK command, or 
until the terminal is turned off or re-initialized. 

If 3270.PFK is executed from a BASIC program, control characters 
(ASCII value less than 32) can be specified in the data. 


:3270.pfk 13 d whoj Stores WHO in PF key 13; no <CR> is 

appended. 

:3270. pfk 23 i offj Stores OFF <CR> in PF key 23. When 

23 is pressed, the user is logged off. 


Any user account on Ultimate S/370 and S/390 systems. 
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:ACTIVATE-LINES 


:ACTIVATE-LINES 

:ACTIVATE-LINES is automatically used at the end of a coldstart or 
file-restore to enable terminal input and output on all lines connected to 
the system. 


Syntax : activate-links 

Description :ACTIVATE-LINES is already part of the COLDSTART command in DICT 
SYSPROG-PL, and should not be used at any other time. 

During a coldstart or file-restore, only line zero (0) is enabled. At the 
end of the procedure, the :ACTIVATE-LINES command in COLDSTART 
enables terminal input and output to all lines connected to the system. 


Available On sysprog or security account. 

See Also COLDSTART 
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.DEBUG-PSYM 


:DEBUG-PSYM 

:DEBUG-PSYM specifies the default symbol file to be used by all lines for 
symbolic debugging. 


Syntax :DEBUG-psym filename {(x) 

filename Specifies the default symbol file for all lines. Default 
filename PSYM is activated during COLDSTART. 

(X Specifies no default symbol file is provided. Requires 

that a filename be entered. 


Description Debugging assembly language programs or troubleshooting system 

problems is much easier when process-relative virtual memory locations 
are referred to by their standard names rather than by absolute frame 
number, offset, and field width. To translate names to locations, the 
system debugger requires a symbol file. 

COLDSTART uses :DEBUG-PSYM to set the default symbol file PSYM for 
all lines. :DEBUG-PSYM can also be executed to change the name of or 
turn off access to the default symbol file. 

To set another symbol file that overrides the :DEBUG-PSYM setting for 
the current line only, use the SET-SYM command. 


: : debug-psym spec . symj Sets the default symbol file for all 

lines to SPEC.SYM. 


Available On sysprog or security account. 


See AISO COLDSTART 

SET-SYM 

Ultimate Assembly Language Reference Guide 
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.DUMP-MODULE 


: DUMP-MODULE 

:DUMP-MODULE allows one or two modules of system software, such as 
the kernel or bootstrap code, to be dumped to tape. 


Syntax :DUMP-module module-number{,module-number} 

module-number The number of a relocatable system software 
module; either one or two modules may be 
dumped. 


Description Several software components of the Ultimate system, such as the 

kernel, programmable controller code, and bootstrap code, are stored as 
relocatable modules on disk. :DUMP-MODULE is used by CREATE-BOOT 
and SYS-GEN to copy the specified module to the beginning of a boot or 
SYS-GEN tape, where it is read in and executed when the computer is 
initialized. 

Each :DUMP-MODULE command creates one tape file terminated by an 
end-of-file mark. The tape file may contain either a single module (such 
as for the Ultimate 6000/7000 system boot), or two modules (such as 
for an LSI system boot). 

Before using :DUMP-MODULE, the tape drive must already be attached 
via T-ATT with the correct block size for the system that will use the boot 
code. 


Available On SYSPROG or SECURITY account. This command is not available on 
Ultimate 1400, S/370, or S/390 systems. 


See Also create-boot 

SYS-GEN 

T-ATT 

System Management Guide for information on creating boot tapes 
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:DUMPTAPE 


■.DUMPTAPE 

Syntax 

Description 


Available On 

See Also 


:DUMPTAPE copies computer memory contents to tape for analysis and 
problem resolution by Ultimate's Technical Assistance Center (TAC). 

Caution: Because the system halts after writing the tape,: DUMPTAPE 
should not he used unless requested by Ultimate TAC. 


:DUMPTAPE 


Analysis of a memory dump may be helpful in troubleshooting certain 
types of system problems. However, interpreting the results requires 
detailed knowledge of both the hardware configuration and the operating 
system release involved. Therefore, memory dump analysis and 
interpretation should be left to Ultimate TAC. 

Note: Entry of: DUMPTAPE on the S/370 or S/390 systems takes you 
to the Error Recovery System (ERS). Memory dump tape 
created from ERS is in a different format than for other 
platforms. 


SYSPROG or SECURITY account. This command is not available on 
Ultimate 1400 systems. 


tMDUMP 

System Management Guide for information on troubleshooting 
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:FILELOAD 


:FILELOAD 


Syntax 


Description 


:FILELOAD initiates a system file-restore from a full file-save tape by 
itself, or along with an update-save tape or a transaction log tape. 

Caution: Any existing database will be deleted from the system. 


:FILELOAD {(options} 


(options 

I Inhibits reallocation based on reallocation parameters on 

the file-save tape. 

M Modulo; adds modulo adjustment information. This 

must be used for a file-restore from systems running 
under revisions prior to 200E. 


.•FILELOAD can be used as an alternative to the F (file-restore) system 
startup option of the bootstrap procedure. Note, however, that while 
.•FILELOAD restores the file section, it does not restore the kernel or 
assembler code frames (ABS). (The F option of the system startup 
procedure restores the kernel, the ABS code, and the files.) :FlLELOAD 
can only be run after the system is booted. 

Before invoking :FILELOAD, make sure of the following: 

» The appropriate tape (full file-save tape, update-save tape, or 
transaction log tape) has been mounted, attached, and is on-line 

• All users are logged off 

When : FILELOAD is invoked without options, a full file restore occurs. 

A full file-save tape created with a FILE-SAVE command must be 
mounted. All accounts and associated files currently on disk are 
deleted, and the system is rebuilt to contain only those accounts and files 
on the tape. 

When the full file restore is finished, the following prompt is displayed: 
Update/transaction tapes (Y/N)? 
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.FILELOAD 


2-16 


If there are no additional update or transaction tapes to be restored in 
addition to the full file restore, enter N to return to TCL. 

If there are additional update or transaction tapes to be restored, enter Y. 

An update restore occurs when an update-save tape created with an ALL¬ 
UPDATE-SAVE or PART-UPDATE-SAVE command is mounted after the 
full file restore of the file save tape is completed. 

A transaction log restore occurs when a transaction log tape produced by 
the LOG command is mounted after the full file restore or update restore 
tape is completed. 

If you enter Y, the following options are displayed: 

Data restore options: 

U - Unload tape 

n - Skip tape forward f n* files 
Tn - Switch to tape drive ’ n 1 

Type option and press <CR>, or just press <CR> to 
continue: 

To unload the current tape, enter U. As the tape is rewound and v -' 

unloaded, the data restore options are redisplayed. When the tape is 
unloaded, mount the next tape and press RETURN. A tape label 
similar to the following is displayed: 

L 2000#time date user-label-name 
Seq# of this data tape: 000 

Seq# of last data tape: 000 

Is this the right tape (Y/N)? 

If the correct tape has been mounted, enter Y. If the correct tape has not 
been mounted, enter N; the prompt is redisplayed. Proceed until all 
tapes have been restored. 

Upon completion, a COLDSTARTis invoked. 


-01 

i 

i 
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The I Option 


The M Option 
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If the I option is specified, the restore proceeds and inhibits any modulo 
reallocation specified on the file-save tape. 


If the M option is specified, a screen similar to the following is 
displayed: 


\ 

Destination frame size: xxxx Source frame size: 0 

File modulos are adjusted whenever frame sizes differ. 
Set source frame size = 0 to read value from tape. 

Enter other values (mod 500) to use as source. 

When not indicated on tape, source frame size defaults 
to destination frame size. 

Enter source frame size or <CR> to accept: 

___ J 


The destination frame size is the frame size of the current system. The 
source frame size is the frame size of the system on which the file-save 
tape was created. To accept the displayed source size, press RETURN; 
otherwise, enter the frame size of the source system. If a new source 
frame size is entered, the following message is displayed: 

Destination frame size:xxxx;Source frame size:yyyy; 
Modulos adjusted 

The restore begins as described above. Load additional tapes as 
prompted until the restore is complete. 

Take care that programs and data restored with : FILELOAD are 
compatible with the existing ABS and kernel code. This situation is not 
usually a problem if the tape was produced under the same operating 
system release as the one used to do the restore. When this is the case, 
check for assembly language code (user exits) required by programs 
being restored. 
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.FILELOAD 


Available 

See Also 


2-18 


However, when restoring data from one release to another, more 
caution is required. Elements stored in files such as verbs, BASIC 
programs, and PROCs can refer to assembly language routines by ABS 
location (mode ID), and can cause damage if the correct software is not 
present. 


On SYSPROG or SECURITY account. 


ALL-UPDATE-SAVE 

LOG 

PART-UPDATE-SAVE 

SAVE 

Operations and Maintenance Guide for your specific platform for 
information on backing up and restoring data. 

System Management Guide for information on bootstrapping, coldstart, 
and file-restore procedures. 
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:INIT-SYSTEM 


:INIT-SYSTEM initializes or resets all group, item, BASIC, and other 
system locks, such as those associated with tape drives and the 
overflow table. The BASIC RND function, which generates random 
numbers, is also reset to its initial value. 

Caution: Arbitrarily clearing locks can result in lost data from Group 
Format Errors (CFEs) and can compromise database 
integrity. 


Syntax :init-system 

Description :INIT-SYSTEM should only be used when a system malfunction has set 
one or more locks that cannot be unlocked in the normal manner. 

:INIT-SYSTEM is performed as part of a coldstart or file-restore. 

:INIT-SYSTEM should never be used on a properly running system, and 
is best done only on the advice of Ultimate TAC personnel. 


Available On sysprog or security account. 


See Also Operations and Maintenance Guide for your specific platform for 

information on troubleshooting. 
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:MDUMP 


:MDUMP 

Syntax 


Description 

Available On 

See Also 

2-20 




:MDUMP formats and displays the contents of a memory dump tape 
created by forcing a memory dump from panel mode or by using the 
:DUMPTAPE command on a 6000/7000 system. Memory dump tapes 
are not normally created or inspected except in consultation with 
Ultimate TAC personnel when troubleshooting certain system problems. 


:MDUMP {options} 


(options 

n Number of a specific memory word address. 

Hexadecimal numbers must be preceded by a decimal 
point (for example, .2d0). 

n-m Numeric range of memory word addresses. Any 

delimiter may be used to separate the numbers as long as 
the delimiter cannot be confused for part of a number. If 
the second number is hex, no delimiter is required (for 
example, .100.C20) 

N No automatic end-of-page waiting. 

P Routes output to the spooler. 



:MDUMP assumes that a memory dump tape has been mounted, the tape 
is at load point, and the tape is attached. The tape block size is 
displayed. The first record on tape is assumed to be the contents of the 
first buffer (512 bytes) in memory, with the following buffers as 
following records until an end-of-file mark is reached. Data is displayed 
in hexadecimal and character format, along with the corresponding 
memory address. Output is compressed by replacing repeated patterns 
of data by a row of asterisks. 


SYSPROG or SECURITY account. 


tDUMPTAPE 

Operations and Maintenance Guide for your platform for information on 
creating a memory dump. 
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:RESTART-BSC 


iRESTART 

Syntax 

Description 

Available On 

See Also 


BSC 


:RESTART-BSC reloads and reinitializes communication controller 
bisynchronous (bisync) operation. 


:RESTART-BSC 


:RESTART-BSC reloads the controller code from disk and reinitializes the 
system’s bisync controllers. Any bisync commands entered before 
:RESTART-BSC must be re-issued. 

:RESTART-BSC can be used to restart a controller that seems to be hung, 
where no information is being transmitted or received through the 
controller, and there is no apparent hardware problem. 


SYSPROG or SECURITY account on Ultimate Bull 6()0()/7000 and LSI 
systems. 


B-ATT 

B-DET 

BSC-DIAL 
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:RESTARTLINE 


:RESTARTLINE 

:RESTARTLINE restarts a hung line. 

Syntax :restartline n 

n Number of the line to be restarted. This line must have 

the <break> key enabled. 

Description :RESTARTLINE executes a SET-BAUD command to reset the terminal 
controller for a specified line, then logs off the line. 


Note: :RESTARTLINE waits until the line's current operation, such as 
a file update, is in a safe state before logging off the line. 



Available On sysprog or security account. 


See Also break-key-on 

LOGOFF 

SET-BAUD 
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:SET-MAX 


Syntax 


Description 


Available On 


6985-3.2 


:SET-MAX-LINES 


LINES 

:SET-MAX-LINES specifies the maximum number of lines that can be 
logged on to the system. 


:SET-MAX-LINES n 

n Specifies the maximum number of lines allowed to log 

on. The default setting for n is 0 (zero), which specifies 
all lines can log on. 


:SET-MAX-LINES is used to prevent additional lines from logging on to 
the system. It has no effect on lines already logged on, and line 0 (zero) 
is always allowed to log on. 

The number of lines allowed to log on is on a first-come, first-served 
basis, and is not related to the line number of any terminal attempting to 
log on. 


:: set-max-lines 4J Sets to 4 the maximum number of lines 

allowed to log on to the system. 

:: set-max-lines OJ All available lines can log on to the 

system. 


SYSPROG or SECURITY account. 
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:STARTSPOOLER 


:STARTSPOOLER 

:STARTSPOOLER restarts the spooler. 

Caution: This command should only be used when there are no open 
print jobs being generated and no print jobs actively printing. 


Syntax :Startspooler {level} 

level: 

(null) First level restart. The spooler's internal variables are 
reinitialized. All closed print jobs and hold files remain 
intact and all job queues and inactive logical printers 
remain undisturbed. 

C Second level restart (similar to spooler reinitialization 

during COLDSTART.) The spooler’s internal variables 
are reinitialized. Spooler software then checks all hold 
files, dequeues all valid print jobs, and retains them as 
hold files. It then detaches all job queues, dequeues all 
logical printers, and sets the SP-ASSIGN command for 
all lines to the S option (no output sent to the spooler). 

I Third level restart (similar to spooler reinitialization 

during file-restore.) The spooler's internal variables are 
reinitialized. Spooler software then removes all print jobs 
and hold files, detaches all job queues, and deletes all 
logical printers. It sets the SP-ASSIGN command for all 
lines to the S option (no output sent to the spooler). 


Description :STARTSPOOLER re-initializes the spooler without coldstarting the entire 

system. 

Note: After either a second or third level restart (with the C or / 

options), the system manager must use SP-STARTLPTR to start 
the logical printers. All users on the system must reset their SP- 
ASSIGN assignments. 
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;STARTSPOOLER 


Available 

See Also 


::STARTSPOOLERJ 

First level spooler restart initiated. 

::STARTSPOOLER CJ 

Second level spooler restart initiated. 

::STARTSPOOLER IJ 

Third level spooler restart initiated. 


On SYSPROG or SECURITY account. 


SP-ASSIGN 

SP-STARTLPTR 
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:TASKINIT 


:TASKINIT 


Syntax 


Description 


2-26 


:TASKINIT displays the number of initialized TCL levels, obtains and 
initializes additional TCL workspaces, or checks linkage of extended 
levels in the overflow table. :TASKINIT operates on a system-wide 
basis. 

:TASKINIT {n} {(C} 

n Specifies the number of TCL levels for which workspace 

is needed. If omitted, the command displays the total 
number of levels currently initialized. The maximum 
value for n is 32767. 

(C Checks all unused, existing extended levels to see if they 

are properly linked. Unusable levels are discarded, and 
their frames are not returned to the overflow table. 

Note: If both n and (C are specified, (C is ignored. If parameters are 
omitted, the total number of initialized levels is displayed. 


Workspaces in the extended level overflow table are initialized for the 
number of TCL levels specified. If the number specified is greater than the 
number of workspaces currently allocated, additional workspaces are 
obtained from the available space pool and initialized. If the number 
specified is less than the number of workspaces currently allocated, the extra 
workspaces are returned to the available space pool unless they are in use. 

•.TASKINIT can be used during startup procedures, such as USER-COLD- 
START, to reserve extra workspace for future use. (Even though the system 
automatically allocates additional workspaces as needed, such allocation 
takes some amount of time. Therefore, performance may be enhanced by 
allocating workspaces at startup time.) 

Note: The size of workspaces for one TCL level varies based on 

frame size. Number of workspace frames is calculated as: 

64 + ((64000/system data frame size) x 3) 
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:TASKINIT 


Available 

See Also 


For example, a system with frame size of 500 bytes would have a 
workspace size of 448 frames. 


On SYSPROG or SECURITY account. 


POVF 

USER-COLD-START 

System Management Guide for information on initializing extended TCL 
workspaces. 
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TRAP 


:TRAP 


Syntax 


Description 


Available On 

See Also 

2-28 


:TRAP increments a trap counter for a specified line in order to suspend 
execution on that line. Execution remains suspended until a 
corresponding number of :UNTRAP commands are issued. 

Caution: .TRAP is intended as a system-level diagnostic tool, and not 
for use in applications. This is due to possible side effects 
that vary from release to release. For example, if a process 
is trapped while it has the overflow table locked, other 
processes needing to use the overflow table will hang until 
the process holding the lock is untrapped. Also, trapping a 
process that has an item lock set may hang other processes 
running the same application. 


ITRAP {n} {Z} 


n 


Specifies the number of the line to trap. Increments the 
trap counter by one for that line. 

z 


Traps all lines except line 0 (zero), other system lines 
such as UltiNet, and the line issuing the command. 

Note: 

Either the n option or the Z option can be specified, but not 
both. 

:TRAP is a system debugging tool. The specified line is rendered 
inactive until an :UNTRAP command is issued. 

: : TRAP 

2 J 

Increments the trap counter by 1 and suspends 
execution on line 2. 

: : TRAP 

ZJ 

Increments the trap counter by 1 for all lines 
except line 0 (zero), other system lines, and the 
line issuing the command. 


SYSPROG or SECURITY account. 


: UNTRAP 
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:UNTRAP 


:UNTRAP 

Syntax 


Description 


Available On 

See Also 

6985-3.2 


:UNTRAP decrements a trap counter for a specified line previously 
trapped by the :TRAP command in order to resume execution on that 
line. Execution can only resume when the number of rUNTRAP 
commands corresponds to the number of :TRAP commands issued for 
the line. 


rUNTRAP {n} {Z} 

n Specifies the number of line to untrap. Decrements the 

trap counter by one for that line. 

Z Decrements the trap counter by one for all lines trapped 

by :TRAP Z. 

Note: Either the n option or the Z option can be specified, but not 

both. 


:UNTRAP is a system debugging tool. If a specified line was previously 
trapped with :TRAP,:UNTRAP decrements the trap counter. However, 
the line is freed only when the trap counter returns to zero. For 
example, if two .-TRAP commands were issued for a line, two rUNTRAP 
commands must be issued to free the line. 


: rUNTRAP 2J 

Decrements the trap counter for line 2 by 1. 

When the trap counter for line 2 reaches 0, line 2 
is freed for execution. 

: rUNTRAP ZJ 

Decrements the trap counter for all trapped lines 
by 1. When the trap counter for a line reaches 0 
(zero), that line is freed for execution. 


SYSPROG or SECURITY account. 


rTRAP 
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iWARMSTART 


:WARMSTART 

:WARMSTART flushes memory and warmstarts the system. The kernel 
is reloaded without losing work that was in progress at the time the 
command was issued; however, output to terminals, printers, or tape 
devices can be lost. 


Syntax :warmstart 

Description :WARMSTART is an alternative to bootstrapping from the CPU control 
panel when recovery is needed from abnormal hardware conditions or 
soft restart situations. For example, use :WARMSTART when all lines 
on a communications controller are hung and need to be restored. 

rWARMSTART first flushes memory to preserve the state of all active 
processes on disk. It then reloads the kernel/firmware, reloads all 
controller software, and starts execution. The processes are brought 
back in from disk and execution resumes where it left off. 


Available On SYSPROG or SECURITY account on Ultimate Bull 6000/7(XX) and LSI 

systems. 


See Also :warmstop 

Operations and Maintenance Guide for your specific platform for 
information on system startup options, including warmstarting and 
stopping. 

System Management Guide for information on bootstrapping. 
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:WARMSTOP 


:WARMSTOP 

Syntax 

Description 


Available On 

See Also 


:WARMSTOP flushes memory to disk and halts the system. 


tWARMSTOP 


rWARMSTOP should be used for any planned shutdown, such as before 
turning the system over to a field engineer for maintenance. 

:WARMSTOP first flushes memory to preserve the state of all active 
processes on disk. It also sets a flag on disk indicating that the system 
was brought down in an orderly manner, with all memory flushed. 
This disk flag is used by the warmstart process when the system is 
brought up again. If this flag is not set, it is assumed that the system 
crashed prior to flushing memory, and several frames can be removed 
from the available space pool in an attempt to prevent Group Format 
Errors (GFEs). 


SYSPROG or SECURITY account. 


:WARMSTART 

Operations and Maintenance Guide for your specific platform for 
information on bootstrapping. 

System Management Guide for information on bootstrapping and 
warmstart. 
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ZLINKED 


rZLINKED 

Syntax 

Description 

Available On 


2-32 


rZLINKED zeros out the linked chain of overflow frames. These frames 
can only be returned to the system after a file-restore. 

Caution: Before entering this command, make sure all users are 
logged off the system. 


rZLINKED 


:ZLINKED can be used if you suspect the overflow table has been 
corrupted, and that deleting the linked portion of the table may prevent 
further group format errors (GFEs). Note, however, that the 
contiguous-frame portion of the overflow table is not affected. The best 
way to ensure valid files and overflow is with a file-save and file- 
restore. 


SECURITY or SYSPROG account. 
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ABS-DUMP 

Syntax 

Description 


6985-3.2 


ABS-DUMP dumps ABS (assembly language software) frames to tape. 
This command should only be used by CREATE-BOOT or SYS-GEN. 

ABS-DUMP 

When a SYS-GEN or boot system backup tape is created, ABS-DUMP 
dumps the coldstart and ABS sections to tape after the bootstrap section 
has been dumped. 

The coldstart section contains system modules and a copy of the ABS 
frames. The ABS section is preceded by a tape label with release level, 
and contains the system and user assembly language software. It is 
followed by an End-of-File (EOF) mark. 

The ABS frames make up the bulk of the Ultimate Operating System, 
and also includes the Ultimate RECALL, BASIC, PROC, and Ultimate 
UPDATE language processors; the various system support and utility 
programs; the relocatable system modules such as kernel memory- 
resident and hardware-specific software; and error messages. 

Before invoking ABS-DUMP, mount and attach a blank tape. When 
ABS-DUMP is entered, the following prompt is displayed: 

ABS tape label: 

Enter the desired label, or press RETURN for no label. The following 
prompt is displayed: 

ABS limits: 

To define the boot tape coldstart section, enter the following: 

Sn,Sm,...,Cw{-x},Cy{-z},... 


where: 

S n, S m,..., S indicates a system module, n and m are 

decimal module numbers, and indicates that 
you may enter as many system modules as 
necessary. 
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ABS-DUMP 


Available 
See Also 
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Cw{-x},Cy{-z},... C indicates frame numbers used by the kernel, 
w{-x} and y{-z} indicate frame numbers or a 
range of frame numbers, and ... indicates that 
you may enter as many frame numbers as 
necessary. 


:ABS-DUMPJ 

ABS tape label: COLDSTART SECTIONJ 

ABS limits: S2,S7,S8,S9,Cl-399,C600-646,C648-2047 J 


Note: Module and frame number lists may be multiple lines, where 
each line but the last ends with a comma (,). 

To define the boot tape ABS section, enter the following: 

Rn,Rm,...,Aw{-x},Ay{-z},... 

where: 

Rn,Rm,..., R indicates a system module, n and m are 

decimal module numbers, and ..., indicates that 
you may enter as many system modules as 
necessary. 

Aw{-x},Ay{-z},... C indicates frame numbers used by virtual, 

w{-x} and y{-z} indicate frame numbers or a 
range of frame numbers, and ... indicates that 
you may enter as many frame numbers as 
necessary. 


:ABS-DUMPJ 

ABS tape label: ABS SECTIONJ 

ABS limits: R124 , R125,A1-399,A600-646,A648-2047J 


Note: Module and frame number lists may be multiple lines, where 
each line but the last ends with a comma (,). 


On SYSPROG or SECURITY account. 


System Management Guide for information on system generation and 
system restore. 
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ACCESS-CODE 


ACCESS- 

Syntax 

Description 


6985-3.2 


CODE 

ACCESS-CODE allows entry of the security code received from Ultimate 
TAC. 


ACCESS-CODE 


On Ultimate S/370 and S/390 operating systems, an access code must be 
entered before the system can be used by a line other than line 0 (zero). 

A temporary access code is included with each new system or upgrade, 
if required. This code must be entered the first time the system is 
coldstarted; a message displayed on line 0 outlines the procedure. Until 
the code is entered, only line 0 can function. 

The system must be Initial Program Loaded (IPLd) after the access code 
is entered in order for the remaining lines to be activated. 

Note: A permanent access code must be requested from Ultimate 
TAC within 45 days of first entering the temporary code. 

ACCESS-CODE prompts for the CPU serial number and the access code: 
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ACCESS-CODE 


Available 

See Also 


2-36 


: ACCESS-CODEJ 

While this program does check the general format of an 
access code entered, it does NOT verify that the code 
given is valid. Please, make sure that the code is 
entered exactly as received from Ultimate support. 

Enter {platform} CPU id, for this CPU (nnnnnnnnn) or 

<CR> to quit: *J 

* Note: the date displayed with the access code is the 
date the code was entered. It is NOT an expiration date! 
CPU id: nnnnnnnnn 

1) mm/dd/yy nnn-AAA-nnA-AnA <— current access-code—< 

2) mm/dd/yy nnn-AAA-nnA-AnA 

n) mm/dd/yy nnn-AAA-nnA-AnA 

Enter new access code, code 1-n (to pick another entry) 
or <CR>: nnn-AAA-nnA-AnAJ 


On SECURITY account on Ultimate S/370 and S/390 systems. 


9370 Operations and Maintenance Guide for information on installing 
the Ultimate Operating System. 
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ACCESS-MAINT 


ACCESS- 


Syntax 


Description 


6985-3.2 


MAINT 

ACCESS-MAINT allows insertion or deletion of retrieval or update locks 
for a specified account and all of its files. 


ACCESS-MAINT {accountname} 

accountname Specifies account for which retrieval or update 

locks should be added or deleted. If omitted, the 
system prompts for it. 


Use ACCESS-MAINT to modify retrieval or update locks. Retrieval and 
update locks allow or deny access to files in a specified account. The 
locks are implemented as lists containing the system and account names 
that are allowed access. 

• If an account has a retrieval lock list, its files cannot be listed, 
edited, or otherwise viewed by users on any account other than 
those specified in the account's retrieval list. 

• If an account has an update lock list, but not a retrieval list, users on 
other accounts can list and otherwise view the first account's files, 
but cannot make changes unless their account is specified in the first 
account's update list. 

When ACCESS-MAINT is invoked without specifying an accountname, 
the following prompt is displayed: 

Enter Account Name or <CR> to End: 


Enter the accountname for which retrieval/update locks are to be set. 
Once an accountname is entered, a Retrieval Locks screen similar to the 
following is displayed: 
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Account Name = MYACCOUNT (Existing) 

Retrieval Locks 

System Name Account Name System Name Account Name 

(LOCAL) MYACCOUNT 

PERSONNEL 

Enter (I)nsert or (D)elete : 

___ / 


To insert accountnames that can have retrieval access to all files in the 
specified account, enter I. To delete accountnames that have retrieval 
access, enter D. (If no list of accounts exists, a delete entry is ignored.) 

Once I or D is entered, the following prompt is displayed: 

Enter System Name ("." for LOCAL): 

Enter a period (.) if the accountname to be inserted or deleted is on the 
local system. If the account is connected via UltiNet, enter the 
account's host system name as defined by UltiNet. 

Once the account's system name is specified, the following prompt is 
displayed: 

Enter Account Name (* for ALL): 


To specify that the names of all accounts be inserted or deleted, enter an 
asterisk (*). To specify individual accounts, enter the account names. 
To return to the system name prompt, press RETURN at the Account 
Name prompt. 

To return to the the (I)nsert or (D)elete prompt, press RETURN at the 
system name prompt. To display the Update Locks screen, press 
RETURN at the (I)nsert or (D)elete prompt. A screen similar to the 
following is displayed: 



r 'x 

W / 
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Available 
See Also 

6985 - 3.2 


- \ 

Account Name = MYACCOUNT (Existing) 

Retrieval Locks 

System Name Account Name System Name Account Name 


(LOCAL) MYACCOUNT 

PERSONNEL 

Enter (I)nsert or (D)elete : 

___ / 


The Update Locks screen is identical to the Retrieval Locks screen. 
Insert or delete names of accounts that can have update access as 
described above for retrieval access. 

Note: To disallow access for all accounts except the one being 
maintained, enter only that accountname under the local 
system. 

When the names of all accounts having retrieval or update access have 
been inserted or deleted, press RETURN until a screen similar to the 
following is displayed: 


\ 

Ultimate Access Code Maintenance 

Retrieval and Update codes will be placed on ALL files 
in account MYACCOUNT as entered. 

Enter <A>ccept, <R>e-enter, or <Q>uit: 

___ J 


To update the indicated account and all files in that account with the 
retrieval and update locks just specified, enter A. To return to the 
Retrieval Locks (I)nsert or (D)elete prompt with all current changes still 
displayed but not yet saved, enter R. To cancel all changes and return to 
TCL, enter Q. 

Note: All new files created in this account will default to the retrieval 
and update lock settings. 

On SYSPROG or SECURITY account. 

UPDATE-ACCOUNT 
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ACCOUNT-RESTORE 

ACCOUNT-RESTORE restores a single account from a SYS-GEN tape, a 
file-save tape, a transaction logger tape, or an account-save tape to an 
existing Ultimate system. 


Syntax ACCOUNT-RESTORE accountname {(options} 

accountname Specifies name to which the saved account will 
be restored on the system; must not already exist 
on the system. 

(options 

I Inhibits reallocation based on reallocation 

parameters on the file-save tape. 

Note: Automatic reallocation can be manually inhibited for 
any particular file by placing an asterisk in attribute 
13 of its file definition item prior to file save. The 
asterisk must immediately follow any reallocation 
parameters: (n)*, or (n,m)*, or (n,m,k)*. 

M Modulo; adds modulo adjustment information. 

This must be used for accounts restored from 
systems with a different frame size running under 
revisions prior to 200E. Cannot be used with the 
U option. 

S Skips initial forward spacing of the tape. Used 

when the restore starts at the beginning of the 
second or later reels of a file-save tape. 

U Update; restores update and transaction log tapes. 

The restore must be started with the first reel of 
the file-save tape or account-save tape, since this 
contains information required by the update and 
transaction log save tapes. Cannot be used with 
the M option. 


Description ACCOUNT-RESTORE restores a single account to the system from tape. 
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Restore with 
No Options 


The restore must be started with the first reel of the file-save tape and 
continued through all file-save tapes until the account is restored. After 
this, update and transaction log tapes can be applied. If no update or 
transaction log tapes are involved in the restore, you can save time by 
using the STAT-FILE listing to determine which reel of the file-save the 
account data starts on, and start the restore with that reel. 

Starting with Revision 200E, all file-save and account-save tapes contain 
an entry that specifies the frame size of the source system. If that tape is 
restored to a 200E or later system with a frame size different from the 
source frame size, the restore process automatically adjusts the file 
modulos so that the files are allocated as efficiently as possible. 

The M option is intended for cases where the frames sizes of the source 
and destination systems differ and the source tape was created on a 
revision prior to 200e. It allows the user to specify the frame size of the 
source system so that the files can be automatically reallocated by the 
system. 

Note: To do an ACCOUNT-RESTORE from a SYS-GEN tape, enter four 

T-FWDs from the tape load point before restoring the account. 
This bypasses the cold-load and ABS-load sections on the 
SYS-GEN tape. 


When ACCOUNT-RESTORE is invoked, the following prompt is 
displayed: 

Account name on tape: 

Enter the saved account name exactly as it was originally saved. The 
following prompt is displayed: 

Password(s) (Y/N)? 

To restore the account with no password, enter N. To restore the 
account with a password, enter Y. The following prompt is displayed: 

Password(s) or <CR> (use password(s) from tape): 

To retain the current passwords as saved on tape, press RETURN. To 
assign new passwords, enter one or more passwords separated by 
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spaces; the passwords are not echoed on the screen. If new passwords 
are entered, the system prompts: 

Re-enter password(s) to confirm: 

Re-enter the passwords to confirm them; the entries are not echoed. 

If the password entries do not match, a password mismatch is indicated 
and the Passwords prompt is redisplayed. 

Once the account is found on tape, the system displays the block size 
message and starts loading the account's files: 


r 


A 

:ACCOUNT-RESTORE AGENTS J 

Account name on tape? AGENTS J 

Password(s) (Y/N)? NJ 


Block 

Size: 8192 


AGENT 



FILEl 

24506,2,1 


FILEm 

14965,1,1 


_ 


J 


As each file is loaded into the system, the filename is displayed, along 
with its starting frame ID (base FID), modulo, and separation. 

Note: If the restore consists of more than one tape reel, mount 
additional reels when the (C)ontinue/(Q)uit prompt is 
displayed. Once the next reel is mounted, enter C. 


The I Option If the I option is specified, the previously described prompts for 

accountname and password are displayed. The restore proceeds, 
inhibiting any modulo reallocation specified on the file-save tape. 
Reallocation based on frame size differences proceeds unless overridden 
by specification of the M option. 
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The M Option If the M option is specified, the previously described prompts for 

accountname and password are displayed. Once that information is 
entered, a screen similar to the following is displayed: 


-N 

Destination frame size: xxxx Source frame size: 0 

File modulos are adjusted whenever frame sizes differ. 
Set source frame size = 0 to read value from tape. 

Enter other values (mod 500) to use as source. 

When not indicated on tape, source frame size defaults 
to destination frame size. 

Enter source frame size or <CR> to accept: 

V___ ) 


The actual frame size of the destination is displayed and the source 
frame size is given as zero. This indicates that the system is to read the 
source frame size from the tape. 

At the prompt, if the frame size is not on tape, enter the frame size of the 
source machine in multiples of 500. The destination and source frame 
sizes are displayed, and the system returns to the file restore options 
menu. 

To accept the default to read the frame size from tape, press RETURN. 

If RETURN is pressed and the tape does not contain the frame size, the 
destination frame size is used and a message similar to the following is 
displayed: 

Destination frame size :xxxx; Source frame size:yyyy; 
Modulos adjusted 

After the frame size is entered, the system proceeds to calculate each 
file's new modulo and restores the file using the new modulo. The 
following formula is used: 

a) The starting value for the calculation is the modulo specified in 
attribute 13 of the file definition item, if any. If that is blank, the 
current modulo in attribute 3 is used. 
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The U Option 


b) If the destination frame size is a multiple of the source frame size, 
the value determined in step a) is divided by the multiple and the 
next lower prime number is used as the new modulo. 

c) If the destination frame size is a fraction of the source frame size, the 
value determined in step a) is divided by the fraction and the next 
higher prime number is used as the new modulo. 

Note: If the destination frame size is the same as the source frame 

size, no reallocation based on frame size occurs regardless of 
the true relative sizes. 

If you entered the U option to use update or transaction tapes, the 
following prompt is displayed after the account is restored from the file- 
save tape: 

Update/transaction tape (Y/N)? 

To restore from an update-save or transaction logger tape, enter Y. The 
following prompt is displayed: 

Account name on tape? 

Specify the account name exactly as it was saved. The following screen 
is displayed: 





Data restore options: 

U - Unload tape 



n - Skip tape forward *n 

1 files 


Tn - Switch to tape drive 

1 n 1 


Type option and press <CR>, or 

just press <CR> to 


continue: 1 

V_ 


y 


If the update or transaction tape is loaded on another drive, enter Tn to 
specify the drive number. The first tape drive is detached and the 
specified drive is attached. 

If the update or transaction logger tape is to be mounted on the current 
tape drive, unload the account-save tape by entering U. The data restore 
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Available 

See Also 


options are displayed again. When the account-save tape is rewound, 
remove it, then mount the update-save or transaction tape, and make 
sure it is loaded and on-line. Press RETURN to continue. 

If your update or tansaction tape consists of more than one reel, you will 
be prompted to mount the next reel as follows: 

Mount next reel, (C)ontinue/(Q)uit? 

If you see this prompt, remove the first reel and mount the next reel. 
When the next reel is loaded and on-line, type C to continue. 

When the tape has been restored, ACCOUNT-RESTORE returns to the 
Update/transaction tape (Y/N) prompt. If there are no more tapes, enter 
N. The TCL prompt is displayed. 


On SYSPROG or SECURITY account. 


ACCOUNT-SAVE 

System Management Guide for information on account-saves and 
restores, and multiple tape procedures. 
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ACCOUNT-SAVE 


ACCOUNT-SAVE saves a single account to tape. 


i'." ' ) 


Syntax 


ACCOUNT-SAVE {(options) 

(options 

B Specifies backward-release compatible; used to save an 

account to be restored on a system running a revision 
prior to 190. It does not dump items greater than 32k, 
but displays their item-IDs on the terminal. Extended 
format items under 32k are saved in regular format. 

D Specifies LSI tape cartridge compatibility mode. This 

option applies to Ultimate Bull 6000/7000 systems when 
reading or writing tape cartridges for use on LSI tape 
cartridge systems. 

L Closes out the current transaction log tape and starts a 

new one. This ensures that any changes made to the 
account after the save starts are logged to an identifiable 
transaction logging tape. If transaction logging is not 
currently active, this option has no effect. 

Note: Your system should have at least two tape drives and 

two terminals to run ACCOUNT-SAVE during transaction 
logging. 



Description Use ACCOUNT-SAVE to save a single account to tape. Only one account 
at a time can be saved, and D-pointers or Q-pointers to the account are 
not saved. No STAT-FILE items are generated. 

If you enter ACCOUNT-SAVE from any account other than SECURITY (or 
SYSPROG with SECURITY status), and attempt to save an account other 
than the one currently logged on, the following message is displayed: 

Account save attempt disallowed. 
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When you invoke ACCOUNT-SAVE, the following prompt is displayed: 

File-save tape label = 

For easy reference, Ultimate recommends that you label your tapes in 
the following format: 

ACCOUNT-SAVE accountname mm-dd-yy 

where mm-dd-yy is the date of the account-save. After labeling, the 
following prompt is displayed: 

Account name = 

Enter the name of the account to be saved, exactly as it appears in the 
system Master Dictionary (MD). The accountname must already exist, 
and must not be a DX, DV, or Q-pointer in the system MD. If the account 
does not meet these criteria, the prompt is redisplayed. 

Once a valid accountname is entered, the following prompt is displayed: 

Password(s) (Y/N)? 

To save the account with no password, enter N. To save the account 
with passwords, enter Y. 

If you entered Y to save with passwords, the following prompt is 
displayed: 

Password(s) or <CR> (use current password(s)): 

To save the account with the current passwords, press RETURN. To 
save the account with different passwords, enter one or more new 
passwords separated by spaces. The passwords are not echoed. 

If the L option is used, the following message is displayed: 

Current LOG tape TOPPED OFF 

Mount reel for next LOG tape 

Enter C when tape is READY and ONLINE. 

The save begins. As each file is written, its reel and file numbers are 
displayed. If multiple tapes are needed for the save, mount them as 
requested by the system. 
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ACCOUNT-SAVE creates an account-save tape that can be used with 
ACCOUNT-RESTORE, SEL-RESTORE, and RESTORE-FILE. 


:ACCOUNT-SAVEJ 

Block size: 8192 
Block size: 8192 

File-save tape label = ACCOUNT-SAVE 07-15-90J 
Account name = CUSTOMERJ 
Password(s) (Y/N)? NJ 

1 1 CUSTOMER 

1 2 FI LEA 

1 3 FILEA 


1 13 FILEZ 

1 13 FILEZ 


On SYSPROG or SECURITY account. 


ACCOUNT-RESTORE 

FILE-SAVE 

LIST-FILE-STATS 

LOG 

SAVE 

Operations and Maintenance Guide for your specific platform. 
System Management Guide for information on account-saves and 
restores and multiple tape procedures. 
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ADDD 

Syntax 

Description 


Available On 

See Also 


6985-3.2 


ADDD adds two decimal integers. 


ADDD n m 

n Specifies first decimal integer, 

m Specifies second decimal integer. 


ADDD adds one decimal integer to another decimal integer and displays 
the result on the terminal. These numbers can range from 0 (zero) to 
± 140737488355327. For the result to be valid, it must also be in the 
same range. 

To enter a negative decimal, enter a minus sign (-) before the number. 


: ADDD 1325 15 J 

Add decimal 1325 to decimal 15. 

1340 

Result. 

: ADDD 1325 -15J 

Add decimal 1325 to decimal -15. 

1310 

Result. 


Any user account. 


ADDX 
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ADDX 

Syntax 

Description 

Available On 

See Also 




ADDX adds two hexadecimal numbers. 


ADDX n m 

n Specifies first hexadecimal number, 

m Specifies second hexadecimal number. 


ADDX adds one hexadecimal number to another. Numbers can range 
from 0 to FFFFFFFFFFFF. If fewer than 12 hexadecimal characters are 
entered, high order zeroes are assumed. Overflow is ignored. 


: addx 5 7J Add hexadecimal value 5 to value 7. 

c Result. 


Any user account. 



ADDD 
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ALL-ACCOUNT-RESTORE 


ALL-ACCOUNT-RESTORE is executed from the SYSPROG account to 
restore from a file-save tape all user accounts not currently on the 
system. 


Syntax all-account-restore {(options) 

(options 

I Inhibits reallocation based on reallocation parameters on 

the file-save tape. 

M Modulo; adds modulo adjustment information. This 

must be used for accounts restored from systems with a 
different frame size running under revisions prior to 
200E. 

U Update; restores update and transaction log tapes. 

Note: Either the l option or the M option may be specified, but not 
both. 


Description ALL-ACCOUNT-RESTORE restores accounts that are not already on the 

system. The file-save tape containing the accounts to be restored must 
have been created using the Ultimate Operating System. 

Note: ALL-ACCOUNT-RESTORE does not restore the following 

accounts: 

ACC 
ATP 

BLOCK-CONVERT 
ERRMSG 
PROCLIB 
SECURITY 

If the UltiLink™, UltiMation m , or UltiWord® (WP) accounts exist on the 
system, they will be overwritten by the tape version. 


SPSYM 

SYSLIB 

SYSPROG 

SYSTEM 

SYSTEM-ERRORS 
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Restore with 
No Options 


The I Option 


The M Option 
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Starting with Revision 200E, all file-save and account-save tapes contain 
an entry that specifies the frame size of the source system. If that tape is 
restored to a 200 e or later system with a frame size different from the 
source frame size, the restore process automatically adjusts the file 
modulos so that the files are allocated as efficiently as possible. 

The M option is intended for cases where the frames sizes of the source 
and destination systems differ and the source tape was created on a 
revision prior to 200 e. It allows the user to specify the frame size of the 
source system so that the files can be automatically reallocated by the 
system. 


When ALL-ACCOUNT-RESTORE is invoked, the system displays the 
block size message and starts loading each account's files. As each file 
is loaded into the system, the filename is displayed, along with its 
starting frame ID (base FID), modulo, and separation. 

Note: If the restore consists of more than one tape reel, mount 
additional reds when the (C)ontinuel(Q)uit prompt is 
displayed. Once the next reel is mounted, enter C. 


If the I option is specified, the restore proceeds but inhibits any modulo 
reallocation specified on the file-save tape. Reallocation based on frame 
size differences proceeds. 

If the M option is specified, a screen similar to the following is 
displayed: 


Ultimate System Commands Guide 6985-3.2 

Confidential and Proprietary to The Ultimate Corp. 


ALL-ACCOUNT-RESTORE 


— 

Destination frame size: xxxx Source frame size: 0 

File modulos are adjusted whenever frame sizes differ. 
Set source frame size = 0 to read value from tape. 

Enter other values (mod 500) to use as source. 

When not indicated on tape, source frame size defaults 
to destination frame size. 

Enter source frame size or <CR> to accept: 

___ J 


The actual frame size of the destination is displayed and the source 
frame size is given as zero. This indicates that the system is to read the 
source frame size from the tape. 

At the prompt, if the frame size is not on tape, enter the frame size of the 
source machine in multiples of 500. The destination and source frame 
sizes are displayed, and the system returns to the file restore options 
menu. 

To accept the default to read the frame size from tape, press RETURN. 

If RETURN is pressed and the tape does not contain the frame size, the 
destination frame size is used and a message similar to the following is 
displayed: 

Destination frame size:xxxx;Source frame sizeiyyyy; 
Modulos adjusted 

After the frame size is entered, the system proceeds to calculate each 
file's new modulo and restores the file using the new modulo. The 
following formula is used: 

a) The starting value for the calculation is the modulo specified in 
attribute 13 of the file definition item, if any. If that is blank, the 
current modulo in attribute 3 is used. 

b) If the destination frame size is a multiple of the source frame size, 
the value determined in step a) is divided by the multiple and the 
next lower prime number is used as the new modulo. 
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c) If the destination frame size is a fraction of the source frame size, the 
value determined in step a) is divided by the fraction and the next 
higher prime number is used as the new modulo. 

Note : If the destination frame size is the same as the source frame 
size, no reallocation based on frame size occurs regardless of 
the true relative sizes. 
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Available On 

See Also 


Automatic reallocation can be manually inhibited for any particular file 
by placing an asterisk in attribute 13 of its file definition item prior to file 
save. The asterisk must immediately follow any reallocation parameters: 
(n)*, or (n,m)*, or (n,m,k)*. 


SYSPROG account. 


ACCOUNT-RESTORE 

Upgrade Procedure for your specific implementation. 


6985-3.2 


Ultimate System Commands Guide 
Confidential and Proprietary to The Ultimate Corp. 


2-55 


ALL-UPDATE-SAVE 


ALL-UPDATE-SAVE 

ALL-UPDATE-SAVE saves to a file-save tape all groups that have been 
updated since the last full FILE-SAVE, PART-UPDATE-SAVE, or SAVE. 


Syntax all-update-save 

Description ALL-UPDATE-SAVE saves all updates to your system since the last FILE- 

SAVE, PART-UPDATE-SAVE, or SAVE. Updates consist of creating, 
changing, or deleting an item, file, or account. ALL-UPDATE-SAVE does 
not reset any group-updated flags. 

By using ALL-UPDATE-SAVE exclusively, only the last full FILE-SAVE 
tape, the last ALL-UPDATE-SAVE tape, and any transaction logging tapes 
are needed to restore the system. 

This contrasts with the exclusive use of PART-UPDATE-SAVE, which 
only saves changes since the last PART-UPDATE-SAVE, and means you 
must have all PART-UPDATE-SAVE tapes and the full FILE-SAVE tape in 
order to restore the system. However, the trade-off is that an ALL- 
UPDATE-SAVE usually takes more time to execute than a PART-UPDATE- 
SAVE. 

ALL-UPDATE-SAVEs, which are classified as incremental saves, are not 
allowed under the following circumstances: 

• A full FILE-SAVE has not been performed since a FILE-RESTORE. 

• Any save attempt is interrupted and prematurely ended, for instance, 
during a crash. 

When ALL-UPDATE-SAVE is invoked, it attaches the tape to drive 0 if the 
tape was not previously attached, rewinds it, displays the time, then 
displays the following prompt: 

Do you want the Console listing to go to the printer? 
(Y/N/X)- 

To send the list of changes being saved to the printer as well as being 
displayed on the terminal, enter Y. To display the list only on the 
terminal, enter N. To terminate the command, enter X. 
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The following prompt is displayed: 

Enter tape block size (500-n) - 

On all IBM systems, and on Ultimate 14(X) systems with half-inch 
drives, n is 32000. On Ultimate 1400 systems with quarter-inch drives, 
n is 31744. On all other systems, n is 8192. Enter the desired tape 
block size. 

The following prompt is displayed: 

Enter Tape Label - 

Enter the information to be stored in the tape label. 

ALL-UPDATE-SAVE then starts. When it is finished, the following 
prompt is displayed: 

Count of System-Errors in the past 2 days 
To Lineprinter (Y/N/X) - 

To print system errors on the printer, enter Y. To display the system 
errors only on the terminal, enter N. For no printing or display of 
system errors, enter X. 

The following message is displayed: 

All-Update-Save finished at time date 

ALL-UPDATE-SAVE then logs off. 
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Available 

See Also 


:ALL-UPDATE-SAVEJ 

Tape attached 
Block size: 8192 
Rewinding... 

End of file 
Rewinding... 

All-Update-Save beginning at 10:11:12 12 NOV 1991 

Do you want the Console listing to go to the printer?(Y/N/X)- YJ 

Enter tape block size (500-8192) - 8192J 

Enter Tape Label - ALL-UPDATE-SAVE 11/12/90J 

Tape attached 

Block size: 8192 

Rewinding... 

Count of System-Errors in the past 2 days 
To Lineprinter (Y/N/X) YJ 

All-Update-Save finished at 12:45:55 12 NOV 1991 

<Connect time- n mins; CPU= n units; lptr pages=0 > 

<Logged off at hh:mm:ss on dd mmm yyyy > 


On SYSPROG or SECURITY account. 


FILE-SAVE 

PART-UPDATE-SAVE 

SAVE 

SYSTEMERRORS 

System Management Guide for information on file-saves. 
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AS 

Syntax 


Description 

Available On 

See Also 


AS assembles assembly language programs for firmware machines. 


AS filename {itemlist} {(options) 


filename Specifies the file containing the items to be assembled. 

itemlist Specifies one or more explicit item-IDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 

(options 

E Lists only errors; used in conjunction with the L option. 

L Generates a listing equivalent to the MUST command 

during assembly. 

N Specifies no automatic end-of-page waiting; useful in 

conjunction with the Z option. 

p Routes output to the spooler. 

Q Specifies that messages are not to be displayed nor the 

editor entered if assembly errors are found; normally, 
this is used when multiple items are being assembled. 

Z Specifies that the editor not be entered if assembly errors 

are found; normally, this is used when multiple items are 
being assembled. 


For more information on assemblies, please refer to the Ultimate 
Assembly Language Reference Guide. 


Any user account. 


ASM 

CROSS-INDEX 

OPT 


6985-3.2 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


2-59 


ASM 


ASM 

Syntax 


Description 

Available On 
See Also 

2-60 


ASM assembles programs on Ultimate 1400 systems. 


ASM filename {itemlist} {(options} 

filename Specifies the file containing the items to be assembled. 

itemlist Specifies one or more explicit item-lDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 

(options 

C Retains comment lines from the source code. 

E Lists only errors; used in conjunction with the L option. 

L Generates a listing equivalent to the MUST command 

during assembly. 

N Specifies no automatic end-of-page waiting; useful in 

conjunction with the Z option. 

P Routes output to the spooler. 

Q Specifies that messages are not to be displayed nor the 

editor entered if assembly errors are found; normally, 
this is used when multiple items are being assembled. 

V Inserts a V.TRAP instruction into the native code before 

each source instruction, instead of just at labels. 

Z Specifies that the editor not be entered if assembly errors 

are found; normally, this is used when multiple items are 
being assembled. 


For more information on assemblies, please refer to the Ultimate 
Assembly Language Reference Guide. 

Any user account. 


AS 

CROSS-INDEX 

OPT 
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B-ATT 


Syntax 


Description 


6985-3.2 


B-ATT attaches and dedicates a bisynchronous (bisync) communications 
controller to the line issuing the command. 


B-ATT {n} 

n Specifies the number of the bisync controller to attach. 

If omitted, controller 0 (zero) is attached. 


B-ATT must be used before any other bisync communications commands 
to ensure that only one user at a time has access to the communications 
processor. The attachment is in effect until a B-DET or an OFF command 
is issued. 

When B-ATT is successful, it raises Data Terminal Ready (DTR) and 
displays the following message: 

[140] BSC Controller attached 

If the specified controller does not exist, the following message is 
displayed: 

[134] No BISYNC communications pac found 

The maximum number of available bisync controllers depends on your 
platform: 

Platform Bisync Controllers 

LSI 3030 3 

LSI 3040 and LSI 3050 4 

All other LSI models 1 

Ultimate 1400 7 

Ultimate Bull 6(X)0/7000 32 
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B-ATT 


Available 


See Also 


2-62 


: B-ATT (2) J 

[140] BSC Controller attached 


/ 0 \ 


On SYSPROG or SECURITY account. This command is not available on 
Ultimate S/370 or S/390 systems. 


:RESTART-BSC 

B-DET 

B-LIST 

BSC-DIAL 

CHANGE-BSC-TIMER 

DISCONNECT 

RAISE-DTR 


f "V 

V y 


V 
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B-DET 


B-DET 


Syntax 


Description 


Available On 


See Also 


B-DET detaches a bisynchronous (bisync) communications controller 
from a line, making it available to other lines. 


B-DET {U,n} 

U Unconditionally detaches a controller not on the current 

line. If omitted, the controller attached to the current line 
is detached. 

n Specifies the number of the bisync controller to detach; 

must be specified if U is specified. 

Note: If parameters are omitted, the controller attached to the current 

line is detached. 


Use B-DET to detach a bisync controller from a line. 


: B-DET (U,0)J 

Unconditionally detaches 


controller zero from its line. 

:B-DETJ 

Detaches the controller from the 


current line. 


SYSPROG or SECURITY account. This command is not available on 
Ultimate S/370 or S/390 systems. 


:RESTART-BSC 

B-ATT 

B-LIST 

BSC-DIAL 

CHANGE-BSC-TIMER 

DISCONNECT 
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B-LIST 


B-LIST 

Syntax 

Description 


Available On 

See Also 


2-64 


B-LIST displays the bisynchronous (bisync) attachment table. 


B-LIST 


B-LIST displays a table showing each bisync controller (BSC) number 
and any attached line number. 

If a controller is attached, the line number to which it is attached is 
displayed under the heading Process#. If the line issuing the command 
has a controller attached to it, an asterisk follows the line number. If the 
controller is not attached, the Process# column contains a hyphen. 


:B-LISTJ 






BSC# Process# 

BSC# 

Process# 

BSC# 

Process# 

BSC# Process# 

0 9* 

1 

5 

2 

- 

3 1 

4 

5 

- 

6 

- 

7 

8 

9 

- 

10 

- 

11 

12 

13 

- 

14 

- 

15 

16 

17 

- 

18 

- 

19 

20 

21 

- 

22 

- 

23 

24 

25 

- 

26 

- 

27 

28 

29 


30 


31 


SYSPROG or SECURITY account. This command is not available on 
Ultimate S/370 or S/390 systems. 


:RESTART-BSC 

B-ATT 

B-DET 

BSC-DIAL 

CHANGE-BSC-TIMER 

DISCONNECT 

WHERE 
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BASIC 


BASIC 


Syntax 


Description 


Available On 


6985 - 3.2 


BASIC compiles an Ultimate BASIC source program to create BASIC object 
code. The object code can then be executed using the RUN command, or the 
program can be cataloged and executed directly from TCL. 

Note: BASIC is an alternative to, and works exactly the same as, the 
COMPILE command. 

BASIC filename itemlist {(options} 

filename Specifies the file containing the source program to compile. 

itemlist Specifies one or more explicit item-IDs (program names), 

or an asterisk (*) to specify all items in the file. 

(options 

C Suppresses end-of-line opcodes from object code. 

F Lists internal variables and labels; used with the M option. 

I Lists lines from SlNCLUDEd programs if the L option is 

specified. 

L Displays line by line listing of the program during 

compilation. 

M Lists map of variables and object layout. 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 

S Suppresses generation of symbol table. 

X Cross-references all labels and variables and stores this 

information in the BSYM file. 


For more information on BASIC programs, please refer to the Ultimate 
BASIC Language Reference Guide. 


Any user account. 
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BLOCK-PRINT 


BLOCK-PRINT 

BLOCK-PRINT prints any ASCII characters in block form on the terminal 
or printer. 


Syntax 


BLOCK-PRINT character-string {(options) 

character-string Specifies the characters to be block-printed. If 
the total number of characters, when block- 
printed, exceeds the current line length set by the 
most recent TERM command, the extra characters 
are wrapped either to the next line or to the next 
screen. 

(options 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 

U Display character-string in upper case letters. 


Description block-print prints characters in an expanded block form. Any 
printable ASCII character can be block-printed. 

No quotation marks are needed to delimit the string unless the string 
already contains a quotation mark. If the string contains a single quote 
('), the string must be enclosed in double quotes (" "), and vice versa. 
For example, to print LET'S GO, enter the string "LET’S GO". 

BLOCK-PRINT checks the BLOCK-CONVERT file and outputs the blocked 
characters as specified. The ASCII character itself is used to produce the 
expanded block. The block height is seven characters, with an 
additional blank line at the bottom of each character. 
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BLOCK-PRINT 


Available 

See Also 


: block-print hello J Block print HELLO on the terminal 


HH 

HH 

EEEEEE 

LL 

LL 

OOOOOO 

HH 

HH 

EE 

LL 

LL 

00 

00 

HH 

HH 

EE 

LL 

LL 

00 

00 

HHHHHHH 

EEEEE 

LL 

LL 

00 

00 

HH 

HH 

EE 

LL 

LL 

00 

00 

HH 

HH 

EE 

LL 

LL 

00 

00 

HH 

HH 

EEEEEE 

LLLLLL 

LLLLLL 

OOOOOO 


: block-print "let's GO" (PJ Block print LET'S GO on 

the printer. 


On Any user account. 


System Management Guide for information on the BLOCK-CONVERT 
file. 
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BMSH 


BMSH 

Syntax 

Description 


Available On 

See Also 


BMSH displays the base, modulo, separation, and hashing algorithm 
information for a specified file. 


BMSH filename 

filename Specifies the file whose base, modulo, separation, and 
hash information is to be displayed. 


The file information is displayed in the following format: 

[425] File 'xyz' base=xxx, modulo=xxx, separ=xxx, hash=x 

where: 

base File location (first frame ID of primary storage). 

modulo Number of groups in primary storage. 

separ Number of contiguous frames per group. 

hash Specifies the algorithm (1 or 2) used to hash the items 

into groups for storage. 

: BMSH DICT BPJ 

[425] File 'BP' base=1247822, modulo=l, separ=l, hash=l 


Any user account. 


System Management Guide for information on base, modulo, 
separation, and hashing algorithm. 
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BOOT-DUMP 


BOOT-DUMP 


BOOT-DUMP writes the boot section of the SYS-GEN tape. This 
command should only be used by SYS-GEN. 
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BREAK-CHR-OFF 


BREAK-CHR-OFF 

BREAK-CHR-OFF disables the <CTRL-C> key sequence from functioning 
the same as the <BREAK> key. 


w 


Syntax break-chr-off {n} 

n Specifies the line number on which the <CTRL-C> key 

sequence should not operate as a <BREAK> key. If 
omitted, the current line is assumed. 


Description BREAK-CHR-OFF disables special handling of the <CTRL-C> key 

sequence. If BREAK-CHR-ON has not been previously entered, no action 
is performed. 


: break-chr-off 31J Disable the <CTRL-C> feature on line 31. 


Available On SYSPROG or SECURITY account on Ultimate Bull 6000/7000 systems. 
See Also break-chr-on 
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BREAK-CHR-ON 


BREAK-CHR-ON 

BREAK-CHR-ON enables the <CTRL-C> key sequence to function the 
same as the <BREAK> key. 


Syntax break-chr-on {n} 

n Specifies the line number on which the <CTRL-C> key 

sequence should operate as a <BREAK> key. If omitted, 
the current line is assumed. 


Description BREAK-CHR-ON enables special handling of the <CTRL-C> key 

sequence. Once enabled, a process can be interrupted at the terminal by 
pressing <CTRL-C>. 

To disable the <CTRL-C> key sequence, use BREAK-CHR-OFF. 

Note : If the <BREAK> key has been disabled, the <CTRL-C> key is 
also disabled. 


: break-chr-on 31 J Enable the <CTRL-C> feature on line 

31. 


Available On SYSPROG or SECURITY account on Ultimate Bull 6()()0/70()0 systems. 

See Also break-chr-off 
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BREAK-KEY-OFF 


BREAK-KEY-OFF 


BREAK-KEY-OFF disables the <BREAK> key for a specified terminal. 


A 

'v_y 


Syntax ijreak-key-off {n} 

n Specifies the line number on which to disable the 

<BREAK> key. If omitted, the current line is assumed. 


Description break-key-off disables the <BREAK> key on the terminal attached to 
the specified line; thereafter processes cannot be interrupted by pressing 
<BREAK> (or <CTRL-C> on Ultimate Bull 6(X)0/7(X)0 systems) if 
BREAK-CHR-ON is set. 

To enable the <BREAK> key on a terminal, use one of the following: 

• BREAK-KEY-ON 

• LOGTO accountname 

• Log off and log on again 


: break-key-off 31 J Disable the <BREAK> key on line 31. 


Available On sysprog or security account. 


See Also break-key-on 
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BREAK-KEY-ON 


BREAK-KEY-ON 


BREAK-KEY-ON enables the <BREAK> key for a specified terminal. 


Syntax break-key-on {n} 

n Specifies the line number on which to enable the 

<BREAK> key. If omitted, the current line is assumed. 


Description BREAK-KEY-ON enables program interruption by pressing the <BREAK> 

key (or <CTRL-C> on Ultimate Bull 6(X)0/7000 systems), if BREAK- 
CHR-ON is set. 


: break-key-on 31J Enable the <BREAK> key on line 31. 


Available On sysprog or security account. 


See Also break-key-off 
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BSC-DIAL 


BSC-DIAL 


Syntax 


Description 


Available On 


See Also 


2-74 


BSC-DIAL initiates automatic dialing on any Ultimate system using 
synchronous modems. 


BSC-DIAL phone-number 

phone-number Specifies the number to be dialed; can consist of 
numbers, blanks, and dashes (-). 


Before invoking BSC-DIAL, use B-ATT to attach the controller connected 
to the modem. You must also set the switch on the front of the modem 
to DATA. 

BSC-DIAL waits for the modem to report call status for up to 45 retries. 


: BSC-DIAL 9-1-213-555-1234J 

[149] BSC AUTO-DIAL CALL PLACEMENT SUCCESSFULLY COMPLETED. 


SYSPROG or SECURITY account. This command is not available on 
Ultimate S/370 or S/390 systems. 


:RESTART-BSC 

B-ATT 

B-DET 

B-LIST 

CHANGE-BSC-TIMER 

DISCONNECT. 
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BUILD-PROC 


BUILD-PROC builds a PROC from a TCL command statement. 


Syntax build-proc tcl.stmt 

tcl.stmt Specifies the TCL command statement to copy into the PROC. 

Description Use BUILD-PROC to build a PROC from any TCL statement, such as a 
complex Ultimate RECALL statement. When invoked, BUILD-PROC 
displays the following prompt: 

Enter PROC item-id: 

Enter the name of the PROC. The PROC is filed in the current MD and 
the following message is displayed: 

PROC "proc.name" created. 

PROCs created with BUILD-PROC have the following format: 

item-ID 
001 PQ 

002 Created by BUILD-PROC on date 
003 Htcl.stmt 
004 P 

Attribute 2 is a comment line that identifies the date the PROC was 
created. Attribute 3 contains the specified TCL command statement. 

To use BUILD-PROC for a statement that has already been executed: 

1. Redisplay the statement from the TCL stack. 

2. Press <HOME> to move the cursor to the beginning of the statement. 

3. Press <Fl> to enter insert mode. 

4. Type BUILD-PROC followed by a space, then press RETURN. 

5. Name the PROC. 

Once created, the PROC can be edited as desired. 


Available On Any user account. 

See Also Ultimate PROC Reference Guide for further information on PROCs. 
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CATALOG 


CATALOG 


Syntax 


Description 


Available On 


2-76 


CATALOG catalogs a compiled BASIC program. Cataloged programs can 
then be used as TCL commands. 


CATALOG 

filename {itemlist} {(options) 

filename 

Specifies the file to be cataloged. 

itemlist 

Specifies one or more explicit item-lDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 

(options 


G 

Causes specified items to be passed to the program, 
instead of being executed by TCL. Changes attribute 1 of 
the item from PC to PC. 

L 

Inhibits execution of the program at logon if the program 
has the same name as the account in which it is 
cataloged. Changes attribute 1 of the item from PC to P. 


For more information about BASIC programs, please refer to the 
Ultimate BASIC Language Reference Guide. 


Any user account. 
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CHANGE-BSC-TIMER 

CHANGE-BSC-TIMER sets the maximum time for bisynchronous (bisync) 
messages to be acknowledged. 


Syntax change-bsc-timer {n} 

n Specifies the number of seconds before a bisync timeout 

occurs. If omitted, the default is 20 seconds. 


Description CHANGE-BSC-TIMER changes the default timeout period for 

acknowledgment of data received via bisync communications. 

: change-bsc-timer 30 J Change timer to 30 seconds. 

: change-bsc-timerJ Reset timer to default 20 seconds. 


Available On SYSPROG or SECURITY account. This command is not available on 

Ultimate S/370 or S/390 systems. 


See Also b-att 

B-DET 

B-LIST 

BSC-DIAL 

DISCONNECT 

RECEIVE 

TRANSMIT 


6985 - 3.2 


Ultimate System Commands Guide 

Confidential and Proprietary to The Uitimate Corp. 


2-77 



CHARGE-TO 


CHARGE 


Syntax 


Description 


TO 


CHARGE-TO terminates the current charge session and adds a specified 
charge name to the current account name. 


CHARGE-TO {chargename} 

chargename Specifies the name to add to the current 

accountname, such as user name or department 
number. Can contain any sequence of letters, 
numbers, or other characters, except for an 
asterisk. The name is added to the current 
accountname, preceded by an asterisk; that is, 
accountname*chargename. If omitted, the 
current account name is charged. 


Use CHARGE-TO to keep track of computer usage for multiple projects 
associated with the same accountname. CHARGE-TO performs the 
following functions: 

• Terminates the current charge session and displays the current 
accounting statistics up to the point when the command is entered. 

• If the account's accounting option is set (via CREATE-ACCOUNT or 
UPDATE-ACCOUNT), it updates the ACC file with the accumulated 
charge-units, line printer pages, and connect-time statistics. 

• Begins a new charge session with the specified name. Use the WHO 
command to display the charge name. 
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CHARGE-TO 


Available 

See Also 


: WHO J 

09 TEST 

:CHARGE-TO PROJECT1J 

<Connect time= 20 mins.; 

:WH0J 

09 TEST*PROJECT1 

:CHARGE-TO PROJECT3J 

<Connect time= 20 rains.; 

: WHO J 

09 TEST*PROJECT3 


Displays the current user name. 


Terminates the current charge 
session, starts a new session, and 
appends PROJECTl to the 
current accountnanie (TEST). 


Displays the new user name. 


Terminates the current charge 
session, starts a new session and 
appends PROJECT3 to the 
current accountnanie (TEST). 


Displays the new user name. 


CPU= 1 units; lptr pages=0 > 


CPU= 1 units; lptr pages=0 > 


On Any user account. 


CHARGE-UNITS 

CHARGES 

CLEAR-ACC-FILE 

WHO 

System. Management Guide for information on the Accounting History 
(ACC) file and user accounts. 
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CHARGE-UNITS 


CHARGE 


Syntax 


Description 


2-80 


UNITS 

CHARGE-UNITS monitors and lists computer usage for one or more 
specified lines. Of the lines specified, it indicates the line with the 
highest usage. 


CHARGE-UNITS {n{-m}} {(options} 

n Displays charge units of line n. If -m is omitted (see 

below), n also displays the user's account name (from 
WHO) and system location (from WHERE). 

-m Displays charge units of lines n through m. 

Note: If line number or range of line numbers is omitted, all lines are 

displayed. 

(options 
A 

L 

T 

Z 

ENTER AMOUNT OF TIME TO SLEEP (SECONDS) ? 


Accumulates charge units when the command is 
invoked. If not specified, units shown are from the time 
the line was logged on, or LOGTO or CHARGE-TO was 
used. Can be used to monitor current usage if used with 
the L option. 

Loops usage display of the lines specified, pausing 
between loops. The default pause is approximately 10 
seconds; to change the value, also specify the Z option. 
To stop the display, press any key. 

Traps the line while units are being accumulated, then 
untraps it. 

Prompts for number of seconds to sleep between loops: 


CHARGE-UNITS measures computer usage. The value of the charge unit 
is hardware dependent. 

The report displays the following information: 
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CHARGE-UNITS 


Available 

See Also 

6985 - 3.2 


LINE# Line number. Lines currently logged on are preceded by 

a plus sign (+); lines not logged on are preceded by a 
minus sign (-). 

CHARGES Accumulated charge units. If the A option is not 

specified, shows the charge units since the line logged 
on. If the line is not currently logged on, charge units 
from the last logon are shown. An asterisk (*) next to 
the charge units column indicates the line invoking the 
command. 

Note: If a line has not logged on since the last coldstart, the value 

displayed for that line is meaningless. 

At the end of the report, the line with the maximum usage and its 
number of charge units is displayed. The current line is not included in 
determining the line with the maximum usage. 

I 

The number of columns displayed can be increased or decreased by 
resetting terminal width with the 132 or 80 commands. 


LINE# 

CHARGES 

LINE# CHARGES 

LINE# 

CHARGES 

LINE# 

CHARGES 

+ 0 

0 

+20 

0 

-40 

0 

-60 

0 

+1 

238 

+ 21 

0 

-41 

0 

-61 

0 

-2 

0 

+22 

1 

-42 

0 

-62 

0 

+ 3 

54 * 

+ 23 

0 

-43 

0 

-63 

0 

+ 4 

0 

+24 

0 

-44 

0 



time 

date ** 

MAX USAGE** 

LINE 

# = 

1 CHARGE 

UNITS 

= 238 


On SYSPROG account. 


CHARGE-TO 

CHARGES 

System Management Guide for information on the Accounting History 
(ACC) file and user accounts. 
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CHARGES 


CHARGES 

Syntax 

Description 


Available On 

See Also 


2-82 


CHARGES displays total connect time, charge units of CPU time, and line 
printer pages accumulated since logon or since the last CHARGE-TO or 
LOGTO command. 


CHARGES 


Use CHARGES to verify the computer usage for a particular logon 
session. CHARGES displays logon statistics as follows: 

< Connect time= n mins.; CPU= m units, lptr pages=x > 

where: 

n Number of minutes logged on to the account, 

m CPU units charged to the account, 

x Pages printed to the line printer. 

Note: CHARGES does not end the current charge session. 

:CHARGESJ 

< Connect time=90 mins.;CPU= 5 units; lptr pages= 0 > 


Any user account. 


CHARGE-TO 

CHARGE-UNITS 

System Management Guide for information on the Accounting History 
(ACC) file and user accounts. 
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CHECK-SUM 


Syntax 


Description 


Available On 


CHECK-SUM is an Ultimate RECALL command that generates a 
checksum for file items. 


CHECK-SUM filename {itemlist} {sel-criteria} {attr} {(P) 

filename Specifies the file to be checksummed. 

itemlist Specifies one or more explicit iteni-IDs. If specified, 
each item-ID must be enclosed in single quotes, double 
quotes, or backslashes. If omitted, the command acts on 
the current select-list, or on all items in the file if no 
select-list is present. 

sel-criteria Conditions that must be met by the specified attr value 
in an item in order for the item to be checksummed. 

Also known as a WITH clause. 


attr Specifies the value of a single attribute to be 

checksummed in the item. If omitted, the entire item is 
checksummed. 

(P Routes output to the spooler. 


For further information on CHECK-SUM, please refer to the Ultimate 
RECALL and Ultimate UPDATE User Guide. 


Any user account. 
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CHECK. REV 


CHECK.REV 


CHECK.REV is used by the upgrade procedures when a new revision is 
installed. It should not be used at any other time. 





.\ 
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CHK-SYSGEN 


CHK-SYSGEN 

CHK-SYSGEN is used by the upgrade procedures when a new revision is 
installed. It should not be used at any other time. 
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CLAIM 


CLAIM 

Syntax 

Description 


Available On 

See Also 


2-86 


/O 

L..y 


CLAIM builds contiguous blocks of overflow space from the individual 
frames contained in the link chain portion of the overflow table. 

Caution: No other users should he on the system when CLAIM is 

running. 


CLAIM 


Ultimate recommends you use CLAIM in the following cases: 

• Contiguous space is getting low. 

• Asa routine step after many of contiguous frames are used. 

• To otherwise reclaim frames until a file-restore reorganizes files into 
contiguous frames. 


Note: Use POVF to display the currently available blocks of 
contiguous frames. 


SYSPROG or SECURITY account. This command is not available on 
Ultimate S/370 or S/390 systems. 


POVF 
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CLEAR-ACC 

Syntax 

Description 


Available On 

See Also 


FILE 

CLEAR-ACC-FILE deletes all logon history items from the Accounting 
History (ACC) file. 

Caution: On timesharing systems that base customer charges on 

ACC data, do not use CLEAR-ACC-FILE until after a 
billing cycle is completed. 


CLEAR-ACC-FILE 


Items in the ACC file are limited to a maximum of 65,536 bytes each. 
Use CLEAR-ACC-FILE periodically to ensure that ACC items do not 
exceed this maximum. 

If an item approaches the maximum byte size, a message similar to the 
following is displayed: 

[333] ACC file statistics item ‘A 1 will soon be too 
large to update. 

If the item reaches the maximum byte size, a message similar to the 
following is displayed: 

[338] ACC file statistics item 'A' is too large to 
update. 


SYSPROG or SECURITY account. 


LISTACC 

System Management Guide for information on the Accounting History 
(ACC) file and user accounts. 
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CLEAR-BASIC-LOCKS 



CLEAR-BASIC-LOCKS clears the BASIC lock table. 

Caution: This command should he used only when directed to by 

Ultimate support personnel. 


Syntax clear-basic-locks 

Description There are 48 BASIC locks (0-47) shared by all BASIC programs on the 

system. 

If a program cannot obtain a lock because another program on a 
different terminal is using it, the program trying to obtain the lock waits 
until the lock is cleared by the program using it. 

To display the BASIC locks on your system, use the WHAT command. 


Available On sysprog or security account. ’ w 


See Also what 

Ultimate BASIC Language Reference Guide for information on LOCK 
and UNLOCK statements. 
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CLEAR-FILE 


CLEAR-FILE clears the dictionary section or data section of a file. 


Syntax 


CLEAR-FILE DICT dictname 
CLEAR-FILE DATA dictname{,dataname} 


DICT Specifies the dictionary section of the file is to be 

cleared. 


DATA Specifies the data section of the file is to be cleared. 


Note: Either Did' or DATA must be specified. 


dictname Specifies the dictionary of the file to be cleared. 

dataname Specifies the data section to be cleared. If dataname is 
omitted and DATA is specified, the dataname that is the 
same as the dictname is assumed. 


Description CLEAR-FILE removes all items from the specified file. It releases any 

extended frames (attached to primary frames) to the system's pool of 
available space. 

When a dictionary is cleared, all items are removed except file definition 
items (D-pointers). 


: CLEAR-FILE DATA INVENTORY, MARCHJ 


Available On sysprog or security account. 


See Also DELETE 

DELETE-FILE 


6985 - 3.2 


Ultimate System Commands Guide 
Confidential and Proprietary to The Ultimate Corp. 


2-89 



CLEAR-INDEX-LOCKS 


CLEAR-INDEX-LOCKS 

CLEAR-INDEX-LOCKS unlocks all indexes for a specified file. 

Caution: This command should be used only when directed by 

Ultimate support personnel. 




Syntax CLEAR-INDEX-LOCKS filename 

filename Specifies the file associated with the index. 


Description Under normal conditions, the system unlocks index locks. However, if 

a process using indexes ends abnormally, an index could remain locked. 
In that case, use CLEAR-INDEX-LOCKS to unlock the index. 

Note: To list index locks, use the LIST-INDEX-LOCKS command. 

No message is displayed when CLEAR-INDEX-LOCKS is complete. Any 
index locks in the file are unlocked and the system returns to the TCL 
prompt. 


Available On Any user account with privilege level 2. 


See Also list-index-locks 
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CLEAR-NAMED-COMMON 

CLEAR-NAMED-COMMON clears named COMMON areas. 

Caution: This command should be used only when directed to by 

Ultimate support personnel. 

Syntax clear-named-common 

Description CLEAR-NAMED-COMMON clears all named COMMON areas from the 
current line. 

Note: To list named COMMON areas, use the LIST-NAMED-COMMON 
command. 

No message is displayed when CLEAR-NAMED-COMMON is complete. 

Available On Any user account. 

See Also list-named-common 

Ultimate BASIC Language Reference Guide 
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CLEAR-STACK 


On 

'o' 


CLEAR-STACK clears the TCL stack of all commands. 


Syntax clear-stack 

Description CLEAR-STACK immediately removes all commands from your TCL 

stack. The next command entered at TCL is stored in entry (X)l. 

N ote: To display current stack entries prior to using CLEAR-STACK, 
use the VIEW command or . (period) command. The VIEW 
command and. command are never stacked. 

Since the stack is not saved by the file-save process, it is cleared during 
every file-restore. 


Available On sysprog or security account. 


See Also . (period) 

SET-STACK 

VIEW 

Chapter 1 of this document for information on the TCL stack. 



2-92 


Ultimate System Commands Guide 
Confidential and Proprietary to The Ultimate Corp. 


6985 - 3.2 




COFF 


COFF 

Syntax 

Description 


Available On 

See Also 

6985 - 3.2 


COFF (Communication OFF) logs off the line issuing the command and 
drops its Data Terminal Ready (DTR) status to low. 


COFF 


COFF performs a logoff procedure similar to the OFF command. 
Differences are: 

• The accounting statistics (such as connect time and CPU units) for 
the session just ended are not displayed. 

• COFF drops the line’s DTR to low for one second before the Logon 
Please message is displayed. 

COFF is used instead of the OFF command to log off a line connected via 
a modem when the modem and/or communications multiplexor requires 
DTR to drop to low during logoff. 

On Ultimate 1400 systems, COFF drops both DTR and Request To Send 
(RTS). 


: COFF J 

26 JUN 1990 07:42:53 Logon please: 


SYSPROG or SECURITY account on Ultimate Bull 6000/7000 systems 
and Ultimate 1400 systems. 


DROP-DTR 

DROP-RTS 

OFF 
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COLDSTART 


COLDSTART executes automatically at the end of the coldstart operation. 
It initializes system parameters and enables all lines. 

COLDSTART should never be used as a TC'L command. You can 
customize coldstarting by modifying USER-COLD-START. 

For further information on coldstarting procedures, please refer to the 
System Management Guide. 
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COMPARE 


Syntax 


Description 


COMPARE compares items in two files and reports if they are equal, 
unequal (same item-lDs with different contents), or missing (item-lD is 
in only one file). 


COMPARE {(options) 


(options 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 


When invoked, COMPARE displays the following prompt: 

ENTER TWO FILE NAMES TO COMPARE FOR EQUAL, UNEQUAL OR 
MISSING ITEMS. FILE NAME CAN OPTIONALLY BE PRECEDED 
BY THE "DICT" MODIFIER 

ENTER FILE NAME TO COMPARE 

Enter the first filename. The following prompt is displayed: 

ENTER SECOND FILE NAME 

Enter the second filename. 

The report lists which items are equal (=), which items are not equal 
(<>), and which items are missing from one of the files (MISS). 

The items in both files are listed twice (see the following example) 
because the items in the first file are tested first, then the items in the 
second file are tested. 
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2-96 


:COMPAREJ 

ENTER TWO FILE NAMES TO COMPARE FOR EQUAL, UNEQUAL OR 
MISSING ITEMS. FILE NAME CAN OPTIONALLY BE PRECEDED BY 
THE "DICT" MODIFIER 


ENTER 

FILE 

NAME TO 

COMPARE CUSTOMERJ 

ENTER 

SECOND FILE NAME USERJ 

FI LEA 

FILEB 

KEY 


= 

= 

ABC 10 

Equal. 

<> 

<> 

CVR10 

Unequal. 


MISS 

LAH10 

In CUSTOMER, not in USER. 

= 

= 

ABC 10 

Equal. 

<> 

<> 

CVR10 

Unequal. 

MISS 


PLC10 

In USER, not in CUSTOMER. 


’v.„y 


On SYSPROG or SECURITY account. 
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COMPILE 


Syntax 


Description 


Available On 


6985-3.2 


COMPILE compiles an Ultimate BASIC source program, creating BASIC 
object code. The object code can then be executed using the RUN command, 
or the program can be cataloged and executed directly from TCL. 

Note: COMPILE is an alternative to, and works exactly the same as, 
the BASIC command. 


COMPILE filename itemlist {(options) 


filename Specifies the file containing the source program to compile. 


itemlist 

(options 

C 

F 

I 

L 

M 

N 

P 

S 

X 


Specifies one or more explicit item-IDs (program names), 
or an asterisk (*) to specify all items in the file. 

Suppresses end-of-line opcodes from object code. 

Lists internal variables and labels; used with the M option. 

If the L option is specified, lists lines from $INCLUDEd 
programs. 

Displays line by line listing of the program during 
compilation. 

Lists map of variables and object layout. 

Specifies no automatic end-of-page waiting. 

Routes output to the spooler. 

Suppresses generation of symbol table. 

Cross-references all labels and variables and stores this 
information in the BSYM file. 


For more information about COMPILE, please refer to the Ultimate BASIC 
Language Reference Guide. 


Any user account. 


Ultimate System Commands Guide 2-97 

Confidential and Proprietary to The Ultimate Corp. 


COPY 


COPY 


Syntax 


COPY copies items from a file to another file, to the same file, to the 
terminal, or to the printer. 


COPY filename {itenilist} {(options) 

filename Specifies the file from which items in the itenilist are to 
be copied. Also known as the source file. 

itemlist Specifies one or more explicit item-IDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 

(options 

A Copies data in editor assembler format; used with the P 

or T options. 

D Deletes the items in the source itemlist after the copy to 

another file is complete. Items are not deleted when they 
are copied to the terminal or printer. 

F Formfeed; starts each item on a new page. Used with the 

P or T options. 

I Inhibits display of item-IDs of copied items. 

N If copying to a file, inhibits creation of new items. Copy 

occurs only if the item-ID already exists, and overwrites 
the existing item. 

If copying to a terminal, specifies no automatic end-of- 
page waiting. 

0 Overwrites existing items. If the destination itemlist 

contains multiple item-IDs with the same name, only the 
last item copied with that name is retained in the 
destination file. 

p Routes output to the spooler. 

S If copying to a file, suppresses the error message listing. 

If copying to printer or terminal, suppresses line 
numbers. 

T Routes output to the terminal. 
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Description 


X Hexadecimal; displays the data in hexadecimal format. 

Used with the PorT options. 


If COPY is invoked without the P or T option, the following prompt is 
displayed: 

To: 

To copy items to the terminal, press RETURN. To copy items to a file, 
enter the following information: 

{(filename) (new-itemlist) 

where: 

(filename The file to which the source file's itemlist will be 

copied. Also known as the destination file. If 
omitted, itemlist is copied back to the source file. 

new-itemlist The itemlist to which the source file's itemlist 

will be copied. If omitted, itemlist is copied with 
the same item-IDs. Multiple item-IDs must be 
separated with blanks. If an item-lD has 
embedded blanks, enclose it in single quotes (for 
example, 'TEST ITEM'). 

Source and destination itemlists can contain different numbers of items. 
If the source itemlist is exhausted first, COPY terminates. If the 
destination itemlist is exhausted first, the remaining item-IDs in the 
source list are copied with no change to their item-ID. 

If the destination itemlist already contains an item-ID that exists in the 
source itemlist, and neither the O nor N options are used, the source item 
is not copied. 

When copying from a dictionary, COPY does not copy file definition 
items (D-pointers), nor does it copy CC-pointers (compiled BASIC 
program object code pointers) or CL-pointers (saved-list pointers). 
Therefore, you cannot use COPY to copy object code or save-lists. To 
copy the object code pointer, copy the source to the data section and 
recompile the file. To copy a list, use COPY-LIST. 
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COPY 


Available 

See Also 


: COPY BP TIME. CONV (TJ 

TIME. CONV 

001 * TIME CONVERSION 
002 PRINT @(-1) 

003 * CONSTANTS 

004 S = 60 

005 PRINT "INPUT HOURS" 

006 INPUT HRS: 

007 PRINT 
008 HRS = HRS * S 
009 PRINT HRS 
010 PRINT 

:COPY CUSTOMER ITEM1 ITEM2J 
To: ITEM5 ITEM6J 

1 ITEM5 

2 ITEM6 

2 items copied 

: COPY DICT CUST * (IJ 
To: (DICT USERSJ 


[418] File definition item 
'CUSTOMER' not copied 


Copy BP item TIME.CONV 
to the terminal. 


Copy ITEM1 and ITEM2 
from file CUSTOMER to 
ITEMS and ITEM6 in file 
CUSTOMER. 


Copy all CUST dictionary 
items to USERS file 
dictionary, and suppress 
itemlist. 

D-pointer not copied, 
all remaining items 
copied. 


23 items copied 


On Any user account. 


COPY-FILES 

COPY-LIST 

CT 
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COPY-FILES 

Syntax 

Description 


COPY-FILES copies items from one data file to another file within the 
current account, or from one account to another. You must have access 
permission in order to copy to or from files in another account. 


COPY-FILES 


When you invoke COPY-FILES, the following prompt is displayed: 

File name that you are copying FROM: 

Enter the filename from which items are to be copied. 

No te : T he DICT section of a file cannot be specified. 

The following prompt is displayed: 

Account name where the FROM file exists: 

Enter the name of the account containing the file. The following prompt 
is displayed: 

File name that you are copying TO: 

Enter the existing filename to which items are to be copied. 

Note: The DICT portion of a file cannot be specified. 

The following prompt is displayed: 

Account name where the TO file exists: 

Enter the name of the account containing the file. The following prompt 
is displayed: 

Do you want to copy all items (Y=<CR>/N)? 

To copy all items, press RETURN. To copy some of the items in the 
file, enter N. The following prompt is displayed: 

Enter item-ids you wish to copy; separate ids with a 
space: 
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Available 

See Also 

2-102 


Enter the item-IDs you want to copy, separated by spaces. The 
following prompt is displayed: 

OVERLAY all existing items (Y=<CR>/N) ? 

To replace all existing items in the file to which you are copying, press 
RETURN. Otherwise, enter N. The following prompt is displayed: 

Is this what you want (Y=<CR>/N)? 

To start the copy, press RETURN. To cancel all previous responses 
and return to the first prompt, enter N. 

When you start the copy, COPY-FILES first checks the files and items for 
validity and access. If the entries are valid, COPY-FILES creates two file 
synonym definition items (Q-pointers), %CFILE and %RFILE, in your 
Master Dictionary. After the items are copied, these Q-pointers are 
deleted. If either %CFILE or %RFILE already exists, the command 
terminates with the message: 

Cannot copy: %CFILE (or %RFILE) already exists in MD 


:COPY-FILESJ 

File name that you are copying FROM: INVJ 

Account name where the FROM file exists: ACCTNGJ 

File name that you are copying TO: INVJ 

Account name where the TO file exists: CUSTOMERJ 

Do you want to copy all items (Y=<CR>/N) ? NJ 

Enter item-ids you wish to copy; separate ids with a 

space: WK1 WK2J 

OVERLAY all existing items (Y=<CR>/N)? YJ 
Is this what you want (Y=<CR>/N)? YJ 

1 WK1 

2 WK2 

2 items copied 


On SYSPROG or SECURITY account. 


COPY 

MOVE-FILE 
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COPY-LIST 


Syntax 


Description 


COPY-LIST copies a saved select-list to another select-list, to a file item, 
or to the terminal or printer. 


COPY-LIST {listname} {(options) 


listname 

(options 

D 


I 

N 

O 

P 


s 


T 


X 


Specifies the saved select-list. Also known as source 
list. If omitted, the system assumes a null item-lD. 

Deletes the select-list after the copy is complete. The 
select-list is not deleted when it is copied to the terminal 
or printer. 

Does not display the item-lD. 

Specifies no automatic end-of-page waiting; used with 
the T option. 

Overwrites existing list. 

Routes output to the spooler. 

Suppresses the line numbers when used with P or T 
option. 

Routes output to the terminal. 

Hexadecimal; displays the data in hexadecimal format. 
Used with P or T options. 


If COPY-LIST is invoked without the P or T option, the following prompt 
is displayed: 

To : 


To copy the list to another select-list (the destination list), enter the 
following: 

listname 

COPY-LIST catalogs the new select-list. When the copy is complete, the 
following message is displayed: 
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Available 

See Also 

2-104 


1 newlistname 1 saved - n frames used. 

To copy the list as a file item, enter the following information: 

(filename {item-iD} 

If no item-iD is specified, the name of the list being copied is used as the 
item-iD. 

COPY-LIST converts the select-list to standard item format, with each 
element of the select-list being stored as an attribute. When the copy is 
complete, the following message is displayed: 

1 items copied 

If the specified item-iD already exists, and the O option is not used, the 
following error message is displayed: 

[415] 'item-ID 1 exists on file 


: COPY-LIST OLD (DJ 

Deletes list when copy is done. 

To -.OLD.CUSTJ 

Copies the list to another list. 

'OLD.CUST' saved - 1 frames 

used. 

:COPY-LIST NEWJ 

To : (RECEIPTS NEW.CUSTJ 

Copies the list to a file item. 

1 NEW.CUST 


1 items copied 



On Any user account. 


EDIT-LIST 

SAVE-LIST 
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COUNT 


Syntax 


Description 


Available On 


6985-3.2 


COUNT is an Ultimate RECALL command that counts the number of 
items specified by the itemlist and selection-criteria. 


COUNT filename {itemlist} {sel-criteria} {(P) 


filename Specifies the file containing items to be counted. 

itemlist Specifies one or more explicit item-IDs. If specified, 
each item-lD must be enclosed in single quotes, double 
quotes, or backslashes. If omitted, the command acts on 
the current select-list, or on all items in the file if no 
select-list is present. 


sel-criteria Conditions that must be met by the item in order for it to 
be counted. Also known as a WITH clause. 


(P 


Routes output to the spooler. 


For further information on COUNT, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 


Any user account. 
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CREATE-ACCOUNT 

CREATE-ACCOUNT creates or updates user accounts and account 
synonyms (Q-pointers), and stores the associated user identification 
items in the SYSTEM dictionary. 


Syntax CREATE-ACCOUNT {accountname} 

accountname Specifies the account to be created or updated. If 

not specified, and the user is on a security 
account, the system prompts for an accountname. 
Users on non-security accounts can only update 
the current account. 


Description Use CREATE-ACCOUNT to create or modify a user account, or a 

synonym (Q-pointer) to an existing user account. 

A user account contains a Master Dictionary and data files, while a 
synonym (Q-pointer) points to an already existing user account. 

Only users on security accounts (SECURITY or SYSPROG with security 
enabled) can create new accounts. Users on non-security accounts can 
only update certain parameters for the current account. 

When CREATE-ACCOUNT is invoked by a security account without an 
account name, the following prompt is displayed: 

Account Name (<CR> to exit) : 

Enter the account name to be created or updated. If you enter an account 
name that is not in the SYSTEM dictionary, the system displays the 
following prompt: 

Defining (A)ccount or (S)ynonym: 

Entering A creates a new account; entering S creates a Q-pointer to an 
existing account. The following sections describe how to create or 
update user accounts or synonyms. 
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Creating a 

User 

Account 


To create a new user account, enter A at the (A)ccount or (S)ynonym 
prompt. A screen similar to the following is displayed: 


r 


ULTIMATE Account Processor 

Account Name: ACCOUNTING (New) 


Dimensions 

1. Modulo, Separation : 29,1 

Security 

2. Password : 

3. System Privileges (0,1,2) :0 

4 . Lines to Allow Logon : 

5. Retrieval Locks (Y,N) :N 

6. Update Locks (Y,N) : N 

Special Options 

7. Accounting Option (Y,N) :N 

8. Restart Option (Y,N) :N 

9. Inhibit Break Key at Logon (Y,N) :N 

10. File-Save Options (V,W,X) : 


k 




Note: To move quickly from field to field or to exit or save your 
changes from any field, enter a slash (!) followed by afield 
number or command. For example, to go to field 3 enter 13 , to 
exit without saving changes enter I EX , or to file all changes 
enter I Ft. 

Each option displays default values, with the cursor positioned at the 
first entry. Enter values as described below: 

1. Modulo, Separation 

The modulo and separation determine the primary space allocated to the 
account. The default of modulo 29, separation 1 is shown (29 groups of 
1 frame each reserved in a contiguous block of disk space). To maintain 
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these defaults, press RETURN; or enter new values for modulo and 
separation. 

2. Password 

One or more passwords can be assigned to the account to provide logon 
security. To specify the default of no password, press RETURN. 

To assign a password, enter the password at the prompt. An account 
can have multiple passwords, any one of which may be used to access 
the account. To specify multiple passwords, enter each password 
separated by a space. 

3. System Privileges 

The three levels of system privilege (0, 1,2) specify the amount of 
access the account has to system functions. To specify the default 
system privilege level 0 (access to most functions), press RETURN. To 
allow the account to access more functions, enter 1. To specify access 
to all functions, enter 2. 

4. Lines to Allow Logon 

This option indicates which lines may log on to the account. To specify 
the default that all lines may log to the account, press RETURN. To 
restrict access to the account to one or more specified lines, enter the line 
number or numbers. 

5. Retrieval Locks 

Retrieval locks prevent users in other accounts from accessing the 
Master Dictionary in the new account. To accept the default value of no 
locks on the account (that is, all other accounts have access to the 
account's Master Dictionary), press RETURN. If you enter Y to add a 
retrieval lock to an account, a screen similar to the following is 
displayed: 
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\ 

Account Name: NEWACCOUNT (New) 

Retrieval Locks 

System Name Account Name System Name Account Name 


BLUE PAYROLL 

Enter (I)nsert or (D)elete: 

___ J 


Enter the network system name and the account names that will be 
allowed to read the information in the new account. 

Note: All new files created in this account will default to the retrieval 

and update lock settings. 


6. Update Locks 

Update locks prevent others from changing the Master Dictionary in the 
new account. To accept the default value of no locks on the account 
(that is, all other accounts may update the account's Master Dictionary), 
press RETURN. If you enter Y to add an update lock to an account, a 
screen similar to the following is displayed: 


Account Name: NEWACCOUNT (New) 

Update Locks 

System Name Account Name System Name Account Name 
BLUE MASTER 

^Enter (I)nsert or (D)elete:_ ^ 


Enter the network system name and the account names that will be 
allowed to change the account's Master Dictionary. 

Note : All new files created in this account will default to the retrieval 
and update lock settings. 

7. Accounting Option 

This option specifies whether or not logon usage statistics for the 
account are maintained in the Accounting History (ACC) file. To specify 
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the default of no accounting, press RETURN. To log statistics for the 
account, enter Y. 

8. Restart Option 

This option specifies that when restarting from the debugger by entering 
END, a logon PROC or other program having the same name as the 
account is executed. To specify the default of no program execution, 
press RETURN. To execute such a program, enter Y. 

9. Inhibit Break Key at Logon 

This option specifies that pressing the <BREAK> key will not abort the 
current process unless the BREAK-KEY-ON command is entered. To 
specify the default of not having this option, press RETURN. To inhibit 
the <BREAK> key, enter Y. 

10. File-Save Options (V,W,X) 

The file save options control whether or not the account is saved during 
normal backup routines, such as a file-save. To specify a file-save 
option, enter one of the following, or press RETURN to select the 
default to always save the file. 

V Does not save the account unless the A (always save) or V option 
is present in the SAVE command. 

W Saves the account unless the W option is present in the SAVE 
command. 

X Does not save the account unless the A option is present in the 
SAVE command. 

After all values for the screen have been entered, the following prompt 
is displayed: 

Enter Option (#,EX,FI) : 

To change any entries, enter the field number. 

To exit this screen without saving any entries, enter EX. The following 
prompt is displayed: 

Cancel of Update Desired (Y,N): 
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Enter Y to cancel the update and return to the Account Name prompt; 
enter N to redisplay the Enter Option prompt. 

To file the account-defining item and create the account, enter FI. A 
Master Dictionary is created and the file-defining item is stored in the 
SYSTEM Dictionary. 

The contents of the prototype Master Dictionary file, NEW AC, are copied 
to the new account's Master Dictionary. The command then returns to 
the Account Name prompt for creation of another new account, if 
desired. To exit the command, press RETURN at the Account Name 
prompt. 


Creating a 

Synonym 

(Q-Pointer) 


To create a synonym (Q-pointer) to an existing account, enter S at the 
(A)ccount or (S)ynonym prompt. The following screen is displayed: 


Linkage 


ULTIMATE Account Processor 


Synonym Name: ACCOUNTING2 (New) 


1. Account Name 


Security 

2. Password : 

3. System Privileges (0,1,2):0 

4. Lines to Allow Logon : 

Special Options 

5. Accounting Option (Y,N) :N 

6. Restart Option (Y/N :N 

7. Inhibit Break Key at Logon (Y,N) 


N 


Each option displays default values, with the cursor positioned at the 
first entry. Enter the values as described below: 
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Updating 

Accounts 

and 

Synonyms 


Available On 


See Also 


1. Account Name 

This option specifies the account name to which the new account should 
point. Enter the account name to point to. 

2. Password through 7. Inhibit Break Key at Logon 

These options all operate the same as when creating a regular account, 
which was described above. 

After the values have been entered, the following prompt is displayed: 
Enter Option (#,EX,FI): 

To change any entries, enter the field number. To exit this screen 
without saving any entries, enter EX. The following prompt is 
displayed: 

Cancel of Update Desired (Y,N): 

Enter Y to cancel the update and return to the Account Name prompt; 
enter N to redisplay the Enter Option prompt. 

To file the synonym, enter FI. The command then returns to the 
Account Name prompt. To exit the command, press RETURN. 


If you enter an account or synonym name that already exists, the 
corresponding screen is displayed with the current values, and the 
cursor is at the Enter Option prompt. To change a value, enter the field 
number at the Enter Option prompt, then enter the new value. 

Note: Users on non-security accounts cannot increase their privilege 

level, nor can they change their Accounting Option entry, 
Restart Option entry, or Inhibit Break Key at Logon entry. 

When all changes have been made, enter FI at the Enter Option prompt 
to save all changes. 

Any user account to update the current account; SECURITY or SYSPROG 
with security enabled to create a new account or update another account. 

UPDATE-ACCOUNT 

System Management Guide for information on creating or updating an 
account’s parameters and creating new user accounts. 
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CREATE-BOOT 


CREATE-BOOT creates a copy of the system boot tape. 


Syntax create-boot 


Description Use CREATE-BOOT to create a copy of the boot tape every time the 

system is upgraded to a new software revision. 

A boot tape contains only the system programs necessary to boot 
(coldstart or warmstart) the system. Unlike the SYS-GEN tape, it does 
not contain the system accounts or system files, and therefore takes less 
time to create. The presence of the accounts WP (UltiWord), ATP, 
UltiMation, and UltiLink are not required to create a boot tape. 

When CREATE-BOOT is invoked, the following screen is displayed: 


Instructions for this program can be found 
in SYSTEM MANAGEMENT Manual. 

This program creates a Boot tape. 

Mount tape, with write ring, on drive n 

ENTER <CR> TO CONTINUE OR END TO EXIT - 

V_ ) 


To create the tape, press RETURN. To exit, enter END. 

Tape and block size messages are displayed, followed by the list of 
frames dumped to tape. At completion, the following message is 
displayed: 

BOOT TAPE CREATION FINISHED 
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Available 

See Also 


Remove the tape from the drive and label it with the current revision 
number (enter REV to see the current revision number). 


On SYSPROG or SECURITY account. 


REV 

SYS-GEN 

System Management Guide 
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CREATE 


Syntax 
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FILE 

CREATE-FILE creates both dictionary and data sections in a new file; 
only the dictionary section; or, if a dictionary already exists, only the 
data section. CREATE-FILE can also be used to change attributes for an 
existing file. 


CREATE-FILE {filename {parameterl} {parameter!}} 

Note: If parameterl and parameter 2 are both omitted, a 

screen is displayedfor entering file parameter values. 

filename Specifies the file to be created. If omitted, the system 
prompts for it. 

parameterl Creates the modulo, separation, and hashing algorithm 

for the dictionary section of the file. These values can be 
user-specified with one of the following formats: 

1) mod,sep{,alg} 

mod Number of groups in primary storage; the 
maximum modulo is 16,777,213. 

se p Number of frames per group in primary 

storage. Separation may be a number from 1 
through 127 when the modulo is 1 through 
65,535, and must be 1 when the modulo is 
greater than 65,535. 

alg Hashing algorithm used to determine group 
in which items are placed. If omitted, the 
algorithm is 1. See the note on the next page. 

2) AC, nl,n2{,alg} 

A C Invokes the automatic modulo calculation 
routine for this file section. See the 
Automatic Modulo Calculation description 
below. 
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Prompt 
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n 1 Estimated number of items in this file section. 

n 2 Estimated size of each item in this file 

section. 

a 1 g Hashing algorithm used to determine in 

which group items are placed. If omitted, the 
algorithm is 1, unless the modulo is greater 
than 64 k, in which case alg is 2, regardless 
of what is specified. 

parameter2 Creates the modulo, separation, and hashing algorithm 
for the data section of the file. These values can be 
specified exactly as shown for parameterl above. 


Use CREATE-FILE to create or update file dictionary and data sections. 

Note: To create a file, a block or blocks of available contiguous 
frames large enough for the entire D1CT and DATA sections 
must exist. Use the POVF command if necessary. 

When a dictionary section is created, disk space is reserved and a D- 
pointer is inserted in the account’s Master Dictionary (MD). 

When a data section is created, disk space is reserved and a pointer to 
the space is placed in the file's dictionary section. 

Files can be created by specifying all parameters at the TCL prompt, or 
by invoking the CREATE-FILE menu. 


When you enter the parameters for the CREATE-FILE statement at the 
TCL prompt, a file definition item is created with the following default 
attributes: 
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Attribute Name Default at Creation 


001 

002 

003 

004 

005 

006 

007 

008 

009 

010 


File Save Option 

Base 

Modulo 

Separation,Algorithm 

Retrieval Lock 

Update Lock 

Conversion 

Correlative 

Justification 

Length 


None. 

Specified by system. 
Specified by user. 
Specified by user. 
Same as account's MD. 
Same as account's MD. 
None. 

None. 

Left. 

10 . 


To change default file attributes, use the menu form of CREATE-FILE. 
(Option 1 can also be changed with the FILEOPT command, while 
Options 5 and 6 can also be changed with the ACCESS-MAINT 
command.) 


Once a file is created at the TCL, the information for each new data and 
dictionary section is displayed in the following format: 

[417] File 1 filename 1 created; base= xx, modulo = xx, 
separ = xx 


where base is the file's location (first frame ID in the block of primary 
storage). 


:CREATE-FILE INVENTORY 3,1 

373,1J 



[417] File 
3, separ = 

' INVENTORY' 

1 . 

created; 

base = 

1038395, 

modulo 

[417] File 
373, separ 

' INVENTORY' 

= 1 . 

created; 

base = 

1875890, 

modulo 
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Automatic 

Modulo 

Calculation 


The Automatic Modulo Calculation routine calculates the modulo as 
follows: 

• Modulos are always prime numbers; the maximum modulo is 
16777213. 

• Separation is always 1. 

• If the average item size is greater than the frame size of the system, 
the modulo will be set the same as the estimated number of items in 
the file and adjusted, if necessary, to the next prime number. With 
perfect distribution, this would place one item in each group. 

• If the average item size is less than the frame size of the system, the 
modulo is calculated according to the following formula: 

no. of items*(item size/frame size) 

The result is rounded up to the next prime number. 


: CREATE-FILE 

T 1,1 AC,30000,75J 


[417] 

File 

I ip ? 

created; base=365102. 

modulo=l, separ=l 

[417] 

File 

1 rp 1 

created; base=782425, 

modulo=4507, separ=l 


In the example above, the estimated size of data items (75 bytes) is less 
than the system's frame size, so the modulo for the data file is based on 
the estimated number of items (30000), multiplied by item size divided 
by frame size (75/500), and rounded up to the next prime number. 


:CREATE-FILE 

T AC,15 

,30, AC, 2000,5000J 

[417] 

File 

t <p 1 

created; 

base=365102, modulo=l, separ=l 

[417] 

File 

I >p I 

created; 

base=782425, modulo=2003, separ=l 


In this example, the estimated size of data items (5000 bytes) is greater 
than the system's frame size, so the modulo is based on the estimated 
number of items (2000), rounded up to the next prime number. 
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Creating 
Files with 
Menu Form 
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If you invoke CREATE-FILE by entering the statement with no filename 
parameter, the following screen is displayed: 


ULTIMATE File Processor 
File Name (<CR> to exit): 

Valid File Name Formats 


file-name 

file-name,file-name 
DICT file-name 
DATA file-name 
DATA file-name,file-name 

_ J 


Enter a valid filename format at the File Name prompt. Depending on 
the filename format entered, the next screen will contain options for 
dictionary section attributes, data section attributes, or both. 

Once a filename is entered, either at the TCL prompt or at the previous 
screen, a screen similar to the following is displayed: 


File Name = NEWFILE (New) 

Dictionary Section 

1. File Options (V,W,X,Y) : 

2. Modulo,Separation,Algorithm : 1,1 

3. Retrieval Locks (Y/N) : N 

4. Update Locks (Y/N) : N 

5. Conversions : 

6. Correlatives : 

7. Justification (L,R,T,U) : L 

8. Length : 10 

Data Section 

9. File Options (V,W,X,Y) : 

10. Modulo,Separation, Algorithm : 1,1 

11. Retrieval Locks (Y/N) : N 


12. 

Update Locks 

(Y/N) : N 

13. 

Conversions : 


14 . 

Correlatives 

: 

15. 

Justification 

(L, R, T, U) 

16. 

Length : 10 
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Attributes for both the dictionary section (1-8) and data section (9-16) 
are identical, although you may want to enter different values for each 
section. The attributes are explained below. 

Note: To move quickly from field to field or to exit or save your 

changes from any field, enter a slash (!) followed by afield 
number or command. For example, to go to field 3 enter 13 , 
to exit without saving changes enter I EX , or to file all changes 
enter I Ft. 

1. File Options (v,w,x,y) 

The file save options control whether or not your file is saved during 
normal backup routines, such as a file-save. To specify a file-save 
option, enter one of the following, or press RETURN to select the 
default to always save the file. 

V Does not save the file unless the A (always save) or V option is 
present in the SAVE command. 

W Saves the file unless the W option is present in the SAVE 
command. 

X Does not save the file unless the A option is present in the SAVE 
command. 

Y Saves the file's space (D-pointer), but not its data. The file will 
be empty when it is restored. 

2. Modulo, Separation, Algorithm 

The modulo, separation, and hashing algorithm determine the physical 
boundaries of your file. The default modulo and separation (1,1) are 
shown, although the default algorithm of 1 is not shown. (To change 
algorithm to 2, enter 2 after the modulo and separation; for example, 
1 , 1 , 2 .) 

At this option, the following prompt is displayed: 

***Enter (AC) - Automatic Calculation of Modulo and 
Separation*** 


To maintain the default, press RETURN. To have the modulo and 
separation automatically calculated by the system, enter AC . The 
following prompt is displayed: 
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Enter Estimated Number of Items: 

Enter the estimated number of items this file will contain. The following 
prompt is displayed: 

Enter Estimated Size of Items (Bytes) : 


Enter the estimated size of the items in bytes (characters). For further 
information, see the previous section on Automatic Modulo Calculation. 

The modulo and separation values are displayed, and the cursor moves 
to the next option. 

3. Retrieval Locks 

Retrieval locks prevent users in other accounts from accessing the files 
in your account. To accept the default value for the account, press 
RETURN. If you enter Y to add a retrieval lock to a file, a screen 
similar to the following is displayed: 


File Name: NEWFILE (New) 

Retrieval Locks 

System Name Account Name System Name Account Name 


BLUE PAYROLL 

Enter (I)nsert or (D)elete: 

___ J 


Enter the network system names and the account names that will be 
allowed to read the information in the new file. For further details, see 
the ACCESS-MAINT command. 

4. Update Locks 

Update locks prevent others from changing the files in your account. 
To accept the default value for your account, press RETURN. If you 
enter Y to add an Update lock to a file, a screen similar to the following 
is displayed: 
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( —- 

File Name: NEWFILE (New) 

Update Locks 

System Name Account Name System Name Account Name 
BLUE MASTER 

^Enter (I)nsert or (D)elete: _^ 


Enter the network system names and the account names that will be 
allowed to change the new file. For further details, see the ACCESS- 
MAINT command. 

5. Conversions 

Conversions affect the way the item-lDs are displayed. Any RECALL 
processing code can be specified. 

6. Correlatives 

Correlatives affect the way the item-IDs are displayed. Any RECALL 
processing code can be specified. 

7. Justification 

Justification affects the way the item-IDs are displayed and sorted. 
Justification can be L (left), R (right), T (text), or U (do not wrap). 

8. Length 

Length is the maximum number of characters to be displayed in a line 
for item-IDs. Excess characters wrap to the next line. 

Enter the desired values for the data section of the file. Once all options 
have been entered, the following prompt is displayed at the bottom of 
the screen. 

Enter Option (#,EX,FI) : 

Enter an option number to return to that option to change it. Enter EX to 
exit this screen without creating the file. Enter FI to create the new file. 
The cursor returns to the filename screen. Enter the name of another file 
to create, or press RETURN to go to TCL. 
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Changing 
Existing File 
Attributes 
with Menu 
Form 


Available On 


See Also 


If you enter the name of a file that already exists, its current attributes 
are displayed and the cursor is positioned at the Enter Option prompt. 
The screen is identical to the screen used to create a new file, except for 
the prompts on lines 2 and 10, which change from Base to the 
following: 

Reallocation (Modulo,Separation,Algorithm): 

Reallocation parameters resize the file the next time the file is saved and 
restored. 


Any user account with privilege level 1 or greater. 


ACCESS-MAINT 

FILEOPT 

UPDATE-FILE 
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CREATE- 


Syntax 


Description 


INDEX 

CREATE-INDEX builds an index for a file, using a specified Ultimate 
UPDATE definition item to build the index's structure. 


CREATE-INDEX {filename} {item-lD} 

filename Specifies the name of the file for which the index is to be 
created. If omitted, the system prompts for it. 

item-lD Specifies the name of the Ultimate UPDATE definition 

item on which to base the index. If omitted, the system 
prompts for it. 


CREATE-INDEX takes information from the specified file and Ultimate 
UPDATE definition item to build an index key structure, which it then 
uses to create the index keys. An index key structure contains the 
following: 

• Attribute number. 

• Attribute conversion. 

• Attribute correlative. 

• Attribute justification. 

• Attribute name. 

» Item-ID justification (from file definition item). 

This index key structure becomes a permanent part of the index. 

After the index key structure is built, CREATE-INDEX uses it to build the 
index, and the system uses it to maintain the index. The system does 
not rely on the Ultimate UPDATE definition item. This approach has the 
following benefits: 

• Integrity of the index is maintained. If the Ultimate UPDATE 
definition item is subsequently changed or deleted, the index is still 
updated correctly, according to the original attribute definition. 

• Because Ultimate RECALL matches the criteria in the Ultimate 
RECALL command to the structure, any number of synonym 
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Available 

See Also 


attribute definition items that match the structure can use the 
corresponding index. 

Note: Although the index is not damaged by changing or deleting the 
Ultimate UPDATE definition item, Ultimate RECALL cannot use 
the index if it does not find an Ultimate UPDATE definition item 
that matches the index structure. Also, Ultimate RECALL 
cannot use the index if the justification of the item-1 D is 
changed, because it is also pan of the index structure. 

Any attribute defined with the same elements used to create the index is 
considered to be an indexed attribute, whether or not it is the original 
Ultimate UPDATE definition item. 

If the Ultimate UPDATE definition item defines the attribute as multi¬ 
valued, one index entry is created for each value in the attribute. If the 
attribute is not defined as multi-valued, one index entry is created for 
each attribute. 


:CREATE-INDEX VENDOR NAMED 

Creating Index . . . 


On Any user account with privilege level 1 or greater. 


DELETE-INDEX 

LIST-INDEXES 

UPD-DEF 
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CROSS-INDEX 

CROSS-INDEX creates a cross index of all symbols used in an assembly 
language program or set of programs. 

Syntax CROSS-INDEX filename {itemlist} {(options} 

filename Specifies the file containing items to be indexed. 

itemlist Specifies one or more explicit item-lDs, or an asterisk (*) 

to specify all items in a file. Can be omitted if a select- 
list is present. 

(options 

F Prompts for the name of a symbol file to use instead of 

PSYM; if not specified, the symbols are searched for in 
PSYM. 

O Creates a cross-index of opcodes instead of operands; 

should be used with the F option. 

Description For further information on CROSS-INDEX, please refer to the Ultimate 
Assembly Language Reference Guide. 

Available On Any user account. 
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Syntax 


Description 


CT 


CT copies specified items to the terminal. 


CT filename {itemlist} {(options} 


filename Specifies the file whose items are to be copied. 


itemlist 


(options 

F 


I 

N 

P 

S 

X 


Specifies one or more item-IDs, or an asterisk (*) to 
specify all items in the file. Can be omitted if a select-list 
is present. 

Formfeed; starts each item on a new terminal or printer 
page. 

Does not display the item-ID. 

Specifies no automatic end-of-page waiting. 

Routes output to the spooler. 

Suppresses display of line numbers. 

Hexadecimal; displays the attributes in hexadecimal 
format. 


CT is an alternative to the COPY command with the T option. 

Unless modified by the I or S options, CT output includes the item-ID on 
the first line and one attribute on each following line. 
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: CT DICT ACC 0 01J 


Available 

See Also 


001 

001 Jeff's office 

002 

003 W 

004 

005 

006 

007 

008 

009 

010 US 
Oil 

012 MD 


x20 0 


: CT DICT ACC 001 (XJ 


001 

002 

003 

004 

005 

006 

007 

008 

009 

010 

Oil 

012 


436C6966662773206F6666696365202020202020202078323030 
57 


5553 
4D4 4 


On Any user account. 


COPY 

LIST-ITEM 
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DATE 

Syntax 

Description 


Available On 

See Also 


DATE displays the current system time and date. 


DATE 


DATE displays the current system time, and displays the date with a two- 
digit day, three-letter month, and four-digit year as shown below: 

hh:mm:ss dd mon yyyy 

Time is based on the 24-hour clock, with midnight at 00:00:00. The 
system updates the date at midnight. 


:DATEJ 

17:15:00 15 MAR 1991 


Any user account. 


SET-DATE 

SET-TIME 

TIME 


6985-3.2 


Ultimate System Commands Guide 
Confidential and Proprietary to The Ultimate Corp. 


2-129 





DECATALOG 


DECATALOG 


Syntax 


Description 


Available On 


2-130 


DECATALOG removes BASIC object code from the system and deletes a 
cataloged program name from an account's Master Dictionary (MD). 


DECATALOG filename {itemlist} 

filename Specifies the file containing items to be decataloged. 

itemlist Specifies one or more explicit item-IDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 


For further information on DECATALOG, please refer to the Ultimate 
BASIC Language Reference Guide. 


Any user account. 
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DELETE 

Syntax 

Description 


Available On 

See Also 


6985-3.2 


DELETE deletes specified items from a file. 


DELETE filename {itemlist} 

filename Specifies the file from which items should be deleted. 

itemlist Specifies one or more explicit item-IDs, or an asterisk (*) 

to specify all items in the file. Can be omitted if a select- 
list is present. 


DELETE deletes the specified items from the file and displays the 
following message for each deleted item: 

1 item-ID* deleted 

If the file is a dictionary, DELETE does not delete items that are file 
synonym definition items (Q-pointers), file definition items (D-pointers), 
compiled BASIC object code (CC-pointers), or save-lists (CL-pointers). 
To delete these items, use CLEAR-FILE, DECATALOG, DELETE-FILE, or 
DELETE-LIST, respectively. 


: DELETE VENDOR ITEM3J 

'ITEM3' deleted. 


Any user account. 


CLEAR-FILE 

DECATALOG 

DELETE-FILE 

DELETE-LIST 
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DELETE-ACCOUNT 


DELETE-ACCOUNT deletes an account and all of its files. 


Syntax DELETE-ACCOUNT {accountname} 

accountname Specifies the account to be deleted. If omitted, 
the system prompts for it. 


Description If you invoke DELETE-ACCOUNT without an account name, the 
following prompt is displayed: 

Account name? 

To go back to TCL, press RETURN; otherwise, enter the name of the 
account to be deleted. DELETE-ACCOUNT checks for the following 
conditions that would prevent it from deleting the specified account: 

• One of several pointers to system files is missing from your Master 
Dictionary. 

• Entering the command from an illegal account, such as from 
SYSPROG if the security feature is not enabled. 

• The specified accountname is a Q-pointer. 

Note: To delete a Q-pointer, delete the account item in the SYSTEM 
directory by entering ED SYSTEM accountname RETURN, 
and then entering FD (file delete) at the line editor prompt. 

• The account has a user logged on. 

• SYSTEM is specified as the account name. 

• The specified accountname is not valid. 

If any of these conditions exist, an error message is displayed and the 
command returns to TCL. 

If none of these conditions exist, the followine Dromnt is disnlaved: 

List files to be deleted (Y=<CR>/N)? 
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Available 

See Also 


6985-3.2 


To see a list of files in the account before it is deleted, press RETURN. 
If you do not want to list the files, enter N. 

If you press RETURN , the following prompt is displayed: 

To the (P)rinter or <CR> screen (P/<CR>)? 


Press RETURN to display the files on the screen, or enter P to print the 
listing. In either case, the following prompt is displayed: 

Do you still want to delete the account (Y/N) ? 

To delete the account, enter Y. To exit without deleting the account, 
enter N. If you enter Y, all files defined in the account are deleted and 
all space associated with those files is returned to available space. Also, 
all Q-pointers to the account are deleted from SYSTEM. 


:DELETE-ACCOUNT TEMPORARYJ 

List files to be deleted (Y=<CR>/N)?NJ 

Do you still want to delete the account (Y/N)?YJ 


On SECURITY account or SYSPROG account if enabled for security. 


System Management Guide for information on user accounts. 
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DELETE-FILE 

DELETE-FILE deletes a specified file. The dictionary section, one or 
more data sections, or all sections of the file can be deleted. 


Syntax DELETE-FILE filename 

filename Specifies the name of the file to be deleted. 


Description Use DELETE-FILE to delete a file. When both the DICT section and all 

DATA sections of a file are deleted, the file definition item (D-pointer) in 
your account’s Master Dictionary (MD) is deleted, the pointers to all data 
files are deleted from the file dictionary, and all frames are returned to 
available space. 

Deletion of the DICT section of a file is allowed only if the file contains 
no DATA sections. 

When just a DATA section is deleted, the pointer for that section is 
deleted from the file dictionary, and space associated with that section is 
returned to available space. Other DATA sections of the file are not 
affected. 

Note: File synonym definition items (Q-pointers) cannot be deleted 
with DELETE-FILE. 


:DELETE-FILE 

DICT 

TEMPORARYJ 

:DELETE-FILE 

DATA 

CUSTOMER,TEMPORARYJ 


Available On Any user account with privilege level 1 or greater. 

See Also clear-ftle 

CREATE-FILE 

Chapter 1 of this document for further information on filenames. 
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DELETE-INDEX 


DELETE-INDEX deletes the specified index. 


Syntax delete-index {filename} {item-iD} 

filename Specifies the file for which the index is to be deleted. If 
omitted, the system prompts for it. 

item-iD Specifies the name of the Ultimate UPDATE definition 
item upon which the index is based. If omitted, the 
system prompts for it. 


Description If an index has not been previously created for the Ultimate UPDATE 
definition specified in the item-iD, the following error message is 
displayed. 

1 item-ID' not on file. 

Note: To list existing indexes, use the LIST-INDEXES command. 


:DELETE-INDEX VENDOR ZIP.CODEJ 

Deleting Index ... 


Available On Any user account with privilege level 1 or greater. 
See Also create-index 

LIST-INDEXES 

Ultimate RECALL and Ultimate UPDATE User Guide 
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DELETE-LIST 


DELETE-LIST deletes a saved select-list. 

Syntax DELETE-LIST {listname} 

listname Specifies the select-list to delete. If omitted, the system 
assumes that the list was saved with a null item-ID. 

Description DELETE-LIST deletes the the pointer to the specified list from the DICT of 

the POINTER-FILE, and returns the frames to available space. The 
following message is displayed: 

[242] ’listname’ decataloged. 

If the list is not found, the following message is displayed: 

'listname' not on file. 

:DELETE-LIST TEMPORARYJ 

[242] 'TEMPORARY' decataloged. 


Available On Any user account. 


See Also EDIT-LIST 

GET-LIST 

QSELECT 

SAVE-LIST 

SELECT 

SSELECT 

Ultimate RECALL and Ultimate UPDATE User Guide 
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DISCONNECT 

DISCONNECT breaks the current bisynchronous telephone connection, 
drops Data Terminal Ready (DTR), and disconnects the modems. 


Syntax disconnect 

Description Use DISCONNECT as an alternative to manually disconnecting the 

telephone line when using bisynchronous 2780-type protocol or 3780- 
type protocol. If necessary, use B-ATT to bring up DTR. 


Available On sysprog or security account. 


See Also 


B-ATT 

B-DET 

B-LIST 

BSC-DIAL 

CHANGE-BSC-TIMER 
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DISK-ADDRESS 

DISK-ADDRESS determines the disk address of a specified frame. 

Syntax disk-address {(p) 

(P Routes output to the spooler. 

Description When DISK-ADDRESS is invoked, the following prompt is displayed: 

Enter frame number : 

Enter a frame number in decimal, or in hexadecimal preceded by a 
period. To return to TCL, press RETURN, or enter X or END. If any 
other non-numeric character is entered, the following message is 
displayed and the command returns to the frame number prompt: 

Not numeric 

DISK-ADDRESS displays the following information, then redisplays the 
Enter frame number prompt: 

FID Frame number in decimal and hexadecimal. 

Drive# Disk drive on which the frame is stored. The drive 

number was assigned when the disk was formatted, or 
when the label was written by the Utility Sub-System 
command D-WRTLAB. 

Channel Channel number of the drive on which the frame is 

stored. If the disk is shadowed, the channel addresses 
of both disks are displayed. 

Cylinder Cylinder number on which the frame is stored. 

Head Head number on which the frame is stored. 

Sector Sector number on which the frame is stored. Frames 

occupy two sectors on Ultimate Bull 6000/7000 disks; the 
sector number displayed is the first sector of the frame. 

Note: The lowest cylinder, head, or sector number is 0 (zero), not 1. 
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DISK-ADDRESS 


Available 

See Also 

6985-3.2 


If the frame is on a track assigned to an alternate track, the address of the 
alternate track is also displayed. The alternate track's channel address is 
displayed, since a shadowed system might have a track assigned to an 
alternate on one of the disks (sibs), but not assigned to an alternate on the 
other disk. If a track is assigned to an alternate on both disks, both 
alternate addresses are displayed. See the second example below. 

If the disk supports alternate sectors, rather than alternate tracks, no 
information is provided regarding whether the frame uses an alternate 
sector. Alternate sectoring is performed automatically by the controller 
and can only be displayed by the Utility Sub-System. 


: DI SK- ADDRES S J 



Enter frame number 

: 30 0 0 00J 

Display disk address of 

FID = 

300000 

(X 1 493E0') 

decimal frame number 

Drive# = 

2 



300000. 

Channel = 

2880 




Cylinder = 

131 




Head = 

19 




Sector = 

75 




Enter frame number 

: 1J 

Display disk address of 

FID = 

1 


<x ' 1 ■) 

decimal frame number 1. 

Drive# = 

1 




Channel = 

6600 

Sib 

channel = B000 

The second channel 

Cylinder = 

0 



indicates this is a 

Head = 

11 



shadowed system. 

Sector = 

2 




Enter frame number 

: .2 07 8 8J 

Display disk address of 

FID - 

133000 

(X'207 8 8’) 

hexadecimal frame 

Drive# = 

1 



number 20788. 

Channel = 

6600 

Sib 

channel = B000 


Cylinder = 

219 




Head = 

6 




Sector = 

16 




***** Alternate 

track assigned ***** 



Channel = 

B000 



Alternate cylinder = 821 

: 


Alternate head = 

7 


On SYSPROG account on Ultimate Bull 6000/7000 systems. 
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DISK-FORMAT 

DISK-FORMAT formats a single disk while the operating system is 
running on another set of disks. 


Syntax DISK-FORMAT channel 

channel Specifies the channel address of the disk to be formatted, 
entered in hexadecimal without a preceding period. 


Description A new disk must be formatted before it can be used. Also, it is often 
desirable and sometimes mandatory to format a disk that has been 
repaired. 

DISK-FORMAT formats a disk while the operating system continues to 
run. The disk being formatted cannot be a member of the active disk 
set, so DISK-FORMAT can only be used when a spare disk drive exists. 

DISK-FORMAT writes header information pointing to the data, and also 
tests for defective areas on the disk. If any defects are found, alternate 
areas are assigned. 

In the past, in order to format a disk it was necessary to run a standalone 
utility, either the diagnostic monitor or the Utility Sub-System (Util). 
Now the formatter in Util is invoked with DISK-FORMAT, although there 
are some differences when running the formatter with DISK-FORMAT 
instead of Util: 

• The disk label is always * FORMATTED** and is always disk 1 of 2. 
This prevents the disk from accidentally being recognized as part of 
a disk set. 

• Terminal I/O uses standard system routines, so when the formatter 
requests input, the standard system terminal input routine prints a 
colon (:), which would not be seen if Util were running. 

When DISK-FORMAT is invoked, it displays the following warning 
message: 

***WARNING*** Format destroys all data! 
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DISK-FORMAT 


If this disk has been previously formatted and the formatter finds a valid 
map of alternate areas, it asks if the previously assigned alternates 
should be retained: 

Save old alternates? (<CR>=Y/N) : 

If you enter Y or press RETURN to save old alternates, the areas 
previously marked as bad by the formatter will continue to be treated as 
bad areas, even if they test good this time. It is recommended that you 
save old alternates, since a marginally unreliable part of a disk cannot 
always be detected by the formatter as bad. 

If the disk has never been formatted by Ultimate, the prompt may not be 
displayed; if it is displayed for a new disk, enter N. 

The disk format begins, and the screen is updated approximately every 
two seconds with a status message indicating the phase (1 through 4) of 
the format procedure and which cylinder is being formatted. Messages 
are displayed whenever a defective area is found and assigned to an 
alternate area. Some messages indicate errors that require an operator 
response. 


: DISK-FORMAT E900J 

***WARNING*** Format destroys all data! 

Save old alternates? (<CR>=Y/N) : YJ 

Format started at 11:43:22 - device has 1635 cylinders 
Chan E900 Phase n cylinder xxx 

Format complete at 13:15:20 Elapsed time : 01:31:57 
Chan defects . status . 

E900 1 O.K. 

[374] Format complete. 


In the example above, the formatter detected no errors other than a 
single previously assigned alternate sector. The n and xxx on the line 
showing the phase represent values that are updated about once every 
two seconds. Note the elapsed time is not the difference between the 
start and end times; this is due to rounding. 
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DISK-FORMAT 


Available 
See Also 

2-142 


: DISK-FORMAT E080J 

***WARNING*** Format destroys all data! 

Channel E080 cycled down! 

Correct above listed problems - press <CR>: J 
Save old alternates? (<CR>=Y/N) : YJ 

Format started at 08:15:23 - device has 1635 cylinders 
Chan E080 Phase n cylinder xxx 

Channel E080 Cyl 349 Head 2 Sect 82 -Defective added 
to error log 

Chan stl st2 cwa cwb cwd rcwa rcwb rcwd task rng rrng 
E080 8800 0000 095D 0252 0000 095D 0252 0000 A942 5F00 0D00 
Chan E080 Phase 4 cylinder 1634 

Format complete at 09:30:58 Elapse time : 01:15:35 
Chan defects . status . 

E080 2 O.K. 

[374] Format complete. 


In the example above, the disk was off-line when DISK-FORMAT was 
invoked. If this occurs, power up the disk and press RETURN. The 
formatter then proceeded; it found one bad sector in addition to one that was 
already in the alternates table. When it found the error, it printed the actual 
status read from the disk. This information can be useful to Ultimate or Bull 
support personnel if many errors are present on one disk. 

Note: If you press <BREAK> and enter the system debugger while 
DISK-FORMAT is executing, the formatter does not stop, 
although it does stop printing the status message. However, 
when the formatter needs to print any other messages, such as 
reporting an error, it stops until the message has been 
displayed. 

To return control to the formatter from the debugger, enter G. 
If you enter END to exit the debugger, the formatter aborts. 

Stacked input and typeahead are not passed to the formatter, 
since many of the formatter's 'requests for terminal input are 
for operator response to errors. 

On SYSPROG account on Ultimate Bull 7000 systems. 

DISK-RESYNC 

Ultimate Bull 600017000 Operations and Maintenance Guide. 
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DISK-RESYNC 

DISK-RESYNC starts copying one disk to another in order to restore disk 
shadowing on Ultimate Bull 7000 systems. 


Syntax DISK-RESYNC source destination 

source Specifies the channel address of the disk that is already 
running as part of the system. Enter in hexadecimal 
without a preceding period. 

destination Specifies the channel address of a sibling disk that is to 
shadow the source disk. Enter in hexadecimal without a 
preceding period. 


Description Each of the following methods can restore shadowing between a disk 
that is part of the operating system and a disk that has just been placed 
on-line: 

DISK-RESYNC Restores shadowing to the sib pair while the system 
is running; this results in the highest system 
availability. 

D-COPY Copies one disk to another; it is faster than DISK- 

RESYNC, but requires that the system be down while 
it is running. This command is part of the Utility 
Sub-System. 

F restore Restores shadowing as it restores the data; this is the 

slowest method. 

DISK-RESYNC begins copying a disk that is part of the operating system 
to another disk. Once the copy is started, the line that executed DISK- 
RESYNC is free to do anything else, while resynchronization continues 
automatically in the background under control of the kernel. DISK- 
STATUS can be used to monitor the resynchronization. 

When DISK-RESYNC is invoked, it checks for the following: 

• There is enough memory for the kernel to allocate track I/O buffers. 

• The source disk is part of the running disk set and is unshadowed. 
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DISK-RESYNC 


• The destination disk channel was detected when the system was 
booted and is not already part of the running disk set. 

If all these conditions are met, the command starts the 
resynchronization, prints the following message, then exits to TCL: 

[361] Disk resynchronization started. 

Caution: DISK-RESYNC does not actually access the disks being 

resynchronized. It is possible for DISK-RESYNC to think 
that resynchronization has been started, when it actually 
failed, perhaps because the destination disk was off-line. 
Use DISK-STATUS to determine the status of the 
resynchronization. See START-RESYNC. 

Before resynchronization, the label on the destination disk can contain 
any set name and sequence numbers. It does not have to have been 
previously written with the on-line set name and correct drive number, 
as is required by D-COPY in the Utility Sub-System. This allows a spare 
disk to be on-line at all times, so that should a disk fail and be 
decoupled, shadowing can be restored immediately, without waiting for 
the actual disk that failed to be repaired. This also allows a disk that has 
been formatted with DISK-FORMAT to be used. In any case, to prevent 
the disk from being configured as part of the on-line system should the 
resync fail, an invalid label is written to the destination disk at the start 
of the resync. 

When the resynchronization is completed, the label of the newly 
resynchronized disk is rewritten and contains the name of the online set 
and all appropriate sequence numbers. 

On a system with no applications running, one sib pair can be 
resynchronized in 20 to 50 minutes, depending on disk size. The time 
increases proportionally with the disk load on the system. 

Conversely, resynchronization slows disk-bound jobs in inverse 
proportion to the number of disk jobs. A busy system is not noticeably 
slowed by resynchronization, but the resynchronization will take a long 
time to complete. 
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Available 

See Also 


Resynchronization uses the same I/O buffers as the fast file save. While 
resynchronization is running, the file save performance enhancements 
introduced in Revision 200 are not in effect. 

Only one sib pair at a time can be resynchronized. If DISK-RESYNC is 
invoked while a resynchronization is underway, the following message 
is displayed: 

[366] Resynchronization already in progress. 


: DISK-RESYNC 2800 E000J 

[361] Disk resynchronization started. 


On SYSPROG account on Ultimate Bull 7000 systems. 


DISK-FORMAT 

DISK-STATUS 

START-RESYNC 

Ultimate Bull 6000/7000 Operations and Maintenance Guide. 
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DISK-STATUS 


DISK-STATUS displays status information about the disk subsystem. 


A 

j 


Syntax 


DISK-STATUS {(options} 

(options 

F Displays D_FLAG bits and D_STATE bits for each disk. 

P Routes output to the spooler. 

Q Displays queued I/O counters for each disk. 

S Displays statistics for each disk; can be used to monitor 

system performance. 

Note: The F, Q, and S options are intended primarily for use by 

Ultimate TAC when there is a suspected problem with the disk 
system. 

X Suppresses the summary information at the beginning of 

the report; intended to be used with S or Q options. 

Note: If options are omitted, the current status of the disk subsystem 
is displayed. 


Description Use DISK-STATUS (without options) periodically on shadowed systems 
to determine if any shadowed disks have failed. It can be used to: 

• Display sib relationships. 

• Identify any disks that have failed and are decoupled. 

• Monitor dynamic resynchronization (DISK-RESYNC). 
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Available 


See Also 


:DISK-STATUSJ 


Current 

Disk Subsystem Status 07:58:35 19 JUN 1991 

Dynamic 

resynchronization 

is in progress. 

Volume 

Channel(s) 

Status 

1 

2800/E000 

Both running shadowed. 

2 

2880/E080 

2880 is being copied to 



E080. 12% done. 


B000 

Formatting. 


On SYSPROG account on Ultimate Bull 6()(X)/7000 systems that support 
shadowing. 


DISK-RESYNC 

Ultimate Bull 600017000 Operations and Maintenance Guide. 
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DISK.COPY 


DISK.COPY copies a multi-disk system by copying the on-line disk set to 
a backup set of removable disks. DISK.COPY is only available on 
Ultimate Bull 6000/7(X)0 systems. 

For further information on DISK.COPY, please refer to the Ultimate Bull 
6000/7000 Operations and Maintenance Guide, Version 3. For further 
information on disk copies, refer to the System Management Guide. 
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DISK.DIAGS 


DISK.DIAGS is used by the ON-LINE-DIAGS command to test for hardware 
problems associated with reading and writing data to disk. Ultimate 
recommends that you use the ON-LINE-DIAGS command to run 
diagnostic tests. 

For further information on DISK.DIAGS, please refer to ON-LINE-DIAGS. 
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DIVD 

Syntax 

Description 

Available On 

See Also 


DIVD divides one whole decimal integer by another whole decimal 
integer. 

DIVD n m 

n Specifies the first decimal integer, 

m Specifies the second decimal integer. 


DIVD divides decimal integer n by decimal integer m. These numbers 
can range from + 140737488355327. 


: DIVD 123456789 23456789J 

5 6172844 


5 is the quotient 
and 6172844 is the 
remainder. 


Any user account. 


ADDD 

DIVX 

MULD 

SUBD 
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DIVX 

Syntax 

Description 


Available On 

See Also 


DIVX divides one hexadecimal number by another hexadecimal number. 


Divx n m 

n Specifies the first hexadecimal number, 

m Specifies the second hexadecimal number. 


DIVX divides hexadecimal number n by hexadecimal number m. These 
numbers can be positive or negative. Negative numbers range from 
FFFFFFFFFFFF to BOOOOOOOOOO1. Positive numbers range from 0 to 
7FFFFFFFFFFF. If fewer than 12 hexadecimal characters are entered, 
high order zeroes are assumed. 


: DIVX A2 52 J 

1 50 

1 is the quotient and 50 (hex) is 

: 

the remainder. 


Any user account. 


ADDX 

DIVD 

MULX 

SUBX 
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DROP-DTR 


Syntax 


Description 


Available On 


See Also 


2-152 


DROP-DTR drops the Data Terminal Ready (DTR) status to low on a 
specified line. 


DROP-DTR {n} 

n Specifies the line on which to drop DTR. If omitted, the 

current line is assumed. 


If DTR is dropped on a dial-up line, the line disconnects and can no 
longer be connected until DTR is raised again. 

If you enter an invalid line number, the following message is displayed: 

[535] Illegal line number 

On 1400 systems, DROP-DTR drops both DTR and Request To Send 
(RTS). 


: DROP-DTR 2J 


SYSPROG or SECURITY account on Ultimate Bull 6000/7000 systems, 
and Ultimate 1400 systems. 


RAISE-DTR 
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DROP-RTS 


Syntax 


Description 


Available On 


See Also 


6985-3.2 


DROP-RTS drops the Request To Send (RTS) status to low on a specified 
line. 


DROP-RTS (n) 

n Specifies the line on which to drop RTS status. If 

omitted, the current line is assumed. 


Use DROP-RTS to drop RTS status to low. The effect of dropping RTS 
depends on what device is connected to the line, and how the line is 
wired. 

If a modem is attached, dropping RTS causes the modem to drop Clear 
To Send (CTS), which in turn causes the system to stop outputting data. 

If you enter an invalid line number, the following message is displayed: 

[535] Illegal line number 

On 1400 systems, DROP-RTS drops both DTR and RTS. 


: DROP-RTS 5J 


SYSPROG or SECURITY account on Ultimate Bull 6000/7000 systems, 
and Ultimate 1400 systems. 


RAISE-RTS 
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DTR 

Syntax 

Description 


Available On 

See Also 

2-154 


Os 

w 


DTR (Decimal To Radix) converts a specified decimal number to its 
equivalent in a specified radix (base). 


DTR (r) n 

r Specifies the radix (base) number. Any radix from 2 to 

16 is valid. If omitted, radix 16 (hexadecimal) is used. 

n Specifies the decimal number to be converted. 


If a non-decimal character (a character other than 0-9) is encountered in 
the number to be converted, the command stops on the last digit before 
the invalid character and converts the value to that point to the specified 
radix. If the non-decimal character is the first character of the number to 
be converted, a value of zero is returned. 


: DTR 8 9AJ 

Converting 9A to radix 8 returns 

11 

11, since 9A is an invalid decimal 


number and the command stops at 9. 

:DTR 2 189J 

Converting 189 to radix 2 (binary). 

10111101 



Any user account. 


DTX 

RTD 
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DTX 

Syntax 

Description 

Available On 

See Also 


DTX (Decimal To Hex) converts a decimal number to its equivalent value 
in hexadecimal. 


DTX n 

n Specifies the decimal number to be converted. If n is an 

invalid decimal number, 0 is returned. 


DTX converts a decimal number to its hexadecimal value. These 
numbers can be in the range ± 140737488355327. 


: DTX 155 J 

9B 


Any user account. 


DTR 

XTD 
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DUMP 


Syntax 


Description 


DUMP displays the data contained in one or more frames. The data can 
be displayed in character or hexadecimal format. 


DUMP nl{-n2} {options} 


nl{-n2} 


options 

G 


I 

L 

N 

P 

U 

X 


Specifies a single frame ID (FID), or range of frame IDs to 
be dumped, in decimal or hexadecimal format. To 
specify in hexadecimal, enter a period (.) before the FID. 


Starts the dump at the first frame and follows either the 
forward or backward links (depending on whether or not 
the U option is specified). The dump terminates when the 
last frame in the logical chain is found. 

Specifies item format dump. 

Specifies that the dump be confined to the links of the 
frames indicated. No data is displayed. 

Specifies no automatic end-of-page waiting. 

Routes output to the spooler. 

Traces the data or links logically upwards to display the 
backward (previous) links. 

Displays data in hexadecimal format as well as ASCII 
character format. 


DUMP displays the contents of specified frames on the terminal or 
printer. Regardless of the option selected, DUMP always displays the 
following columns of information for each frame: 


• Column 1 

• Column 2 

1-o 

C-UiUlllll J 

• Column 4 

• Column 5 


Frame ID (FID). Preceded by a plus sign (+) if a 
forward link, a minus sign (-) if a backward link 

Number of next contiguous frames (NNCF). 

Forward link (FID of next logical frame). 

Backward link (FID of previous logical frame). 

Number of previous contiguous frames (NPCF). 
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DUMP 


Available On 

See Also 


6985-3.2 


* Column 6 (Data in parentheses) is the data in columns 1 

through 5, displayed in hexadecimal format. 

The data in the frame may or may not be displayed, depending on the 
options selected. 


:dump 6950 lj Link-only dump option. 

FID: 6950 : 0 6967 0 0 ( 1B26 : 0 1B37 0 0 ) 

+FID: 6967 : 0 0 6950 0 ( 1B37 : 0 0 1B26 0 ) 


:DUMP . 1DC81 xj Display data in decimal and hexadecimal. 


FID: 

121985 : 

0 122174 0 

0 ( 1DC81 

0 1DD3E 

0 0 

0000 

00000001 

DD3E0000 

0000000 

31324137 

0 

:.J>. 

12A7: 

0010 

4155544F 

52414345 

FE202020 

20202044 

16 

:AUTORACE A 

D: 

0020 494D2057 

494E2835 

292C4452 

49564552 

32 

: IM WIN(5),DRIVER: 

0030 

2835292C 

4155544F 

283529FE 

20202020 

48 

: (5),AUT()(5) A 


0040 

20205041 

5553453D 

35FE2020 

20202020 

64 

: PAUSE=5 A 


0050 

55503D40 

282D3130 

29FE2020 

20202020 

80 

: UP=@(-10) A 



SYSPROG or SECURITY account. 


GROUP 
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EBASIC 


Syntax 


Description 


Available On 


2-158 


EBASIC compiles an Ultimate BASIC source program to create BASIC object 
code. The object code can then be executed using the RUN command, or 
the program can be cataloged and executed directly from TCL. 

Note: EBASIC operates the same as BASIC and COMPILE, but is used 
to compile source items created with EEDIT. 


EBASIC filename itemlist {(options) 


filename Specifies the file containing the source program to compile. 


itemlist 

(options 

C 


F 


I 

L 

M 

N 


Specifies one or more explicit item-lDs (program names), 
or an asterisk (*) to specify all items in the file. 


Suppresses end-of-line opcodes from object code. 

Lists internal variables and labels; used with the M 
option. 

Lists lines from $lNCLUDEd programs if the L option is 
specified. 

Displays line by line listing of the program during 
compilation. 

Lists map of variables and object layout. 

Specifies no automatic end-of-page waiting. 


P Routes output to the spooler. 

S Suppresses generation of symbol table. 

X Cross-references all labels and variables and stores this 

information in the BSYM file. 


For more information on EBASIC, please refer to the Ultimate BASIC 
Language Reference Guide. 


Any user account. 
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ECHO-OFF 

Syntax 

Description 


Available On 

See Also 


6985-3.2 


ECHO-OFF deactivates the terminal echo feature. Characters entered at 
the keyboard are not displayed on the screen. 


ECHO-OFF {n} 

n Specifies the line on which to deactivate terminal echo. 

If omitted, the current line is assumed. 


When ECHO-OFF is used, characters entered at the keyboard are not 
displayed on the screen. However, characters entered at TCL are placed 
in the TCL stack and can be retrieved using TCL stack commands such as 
VIEW. 

To restart terminal echo, use ECHO-ON. 


: echo-off 4J Information entered on line 4 is 

no longer displayed on that line's 
: screen. 


Any user account. 


ECHO-ON 
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ECHO-ON 

Syntax 

Description 

Available On 

See Also 


2-160 


ECHO-ON activates the terminal echo feature. Characters entered at the 
keyboard are displayed on the terminal screen. 


ECHO-ON {n} 

n Specifies the line on which to activate terminal echo. If 

omitted, the current line is assumed. 


Characters entered at the keyboard are displayed on the terminal screen. 

Note: When your system is coldstarted, terminal echo is activated for 
all lines. 


: echo-on 2 J Information entered at line 2 is displayed 

on that line's screen. 


Any user account. 


ECHO-OFF 
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ECOPY 


ECOPY 


Syntax 


ECOPY copies items from a file to another file, to the same file, to the 

terminal, or to the printer. 

Note: ECOPY operates the same as COPY, but is used to expand 
blank and asterisk fields compressed with EEDIT. 

ECOPY filename {itemlist} {(options) 

filename Specifies the file from which items in the itemlist are to 
be copied. Also known as the source file. 

itemlist Specifies one or more explicit item-IDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 

(options 

A Data copied in assembler format; used with the P or T 

options. 

D Deletes the items in the source itemlist after the copy to 

another file is complete. Items are not deleted when they 
are copied to the terminal or printer. 

F Formfeed; starts each item on a new page; used with the 

P or T options. 

I Inhibits display of item-IDs of copied items. 

N If copying to a file, inhibits creation of new items. Copy 

occurs only if the item-ID already exists, and overwrites 
the existing item. If copying to a printer or terminal, 
inhibits automatic end-of-page waiting. 

O Overwrites existing items. If the destination itemlist 

contains multiple item-IDs with the same name, only the 
last item copied with that name is retained in the 
destination file. 

P Routes output to the spooler. 

S If copying to a file, suppresses the error message listing. 

If copying to printer or terminal, suppresses line 
numbers. 


6985-3.2 


Ultimate System Commands Guide 
Confidential and Proprietary to The Ultimate Corp. 


2-161 


ECOPY 


Description 


T Terminal; routes copy data to the terminal. 

X Hexadecimal; displays the data in hexadecimal format; 

used with the P or T options. 


Because EEDIT compresses redundant blanks and asterisks, the source 
item can be reduced considerably. Use ECOPY to expand an item to its 
original size before its blanks and asterisks were compressed by EEDIT. 
ECOPY creates copies of items that are expanded to their uncompressed 
form. 

If ECOPY is invoked without the T or P option, the following prompt is 
displayed: 

To: 

To copy items to the terminal, press RETURN. To copy items to a file, 
enter the following information: 

{(filename)} {itemlist} 

(filename Copy items to a new file, known as the destination file. 

If omitted, items are copied to the source file. 

itemlist Copy items to new item-lDs in the source or destination 
file. If omitted, items are copied with the same item-IDs. 
Separate multiple item-IDs with blanks. If an item-ID has 
embedded blanks, enclose the item-ID in single quotes 
(for example, 'TEST ITEM’). 

Item-IDs can be repeated within the itemlist. However, if you use the O 
or N option, only the last item copied with the same name is retained in 
the destination file. If you do not select the 0 or N option and the item- 
list contains an item-ID that already exists, the source item is not copied. 

The source and destination itemlists can contain different numbers of 
items. If the source itemlist is exhausted first, the ECOPY terminates. If 
the destination itemlist is exhausted first, the remaining item-IDs are 
copied with the original item-in. 

When copying a dictionary, ECOPY does not copy file definition items 
(D-pointers) to another file. You can only create D-pointers with 
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ECOPY 


Available 

See Also 

6985-3.2 


CREATE-FILE. The CC-pointers and CL-pointers created by BASIC, 
COMPILE, COPY-LIST, EDIT-LIST, and SAVE-LIST are not copied. 
Therefore, you cannot use ECOPY to copy BASIC object code or saved 
lists. 


: ECOPY BP TIME.CONVERT 

(TJ 


TIME.CONVERT 



001 

******************************* 


002 

******* TIME CONVERSION 

******* 


003 

******************************* 


004 

PRINT @(-1) 



005 

**** CONSTANTS 



006 

S = 60 



007 

PRINT ”INPUT HOURS:” 



008 

INPUT HRS 



009 

PRINT 



010 

HRS = HRS * S 



011 

PRINT HRS 



012 

PRINT 



:ECOPY CUSTOMER ITEM1 ITEM2J 

ITEM5 and ITEM6 

To 

:ITEM5 ITEM6J 

1 ITEMS 

2 ITEM6 


are in expanded 
(normal) format. 

2 items copied 



:ECOPY DICT CUSTOMER * 

(X) J 


To 

:(DICT USERS) J 



[418] File definition item 

'CUSTOMER' 

was not copied 

23 

items copied 




On Any user account. 


COPY 

EEDIT 
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ED{IT} 


ED{IT} 


Syntax 


Description 


Available On 




ED{IT} invokes the line editor, with which you can create or edit 
Ultimate file items. 


ED {IT} filename {itemlist} {(options) 

filename Specifies the name of the file containing the item or items 
to be edited. 


itemlist 


(options 

A 

M 

P 


Specifies one or more explicit item-lDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 

Displays assembly code source programs in standard 
assembly listing format. 

Displays macro expansions when used with the A 
option. 

Routes output to the spooler. 


S Suppresses display of line numbers, or suppresses 

display of object code if used with the A option. 

X Displays data retrieved from the editor in hexadecimal 

format. 



For more information on ED{IT}, please refer to the Guide to the 
Ultimate Editors. 


Any user account. 
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EDIT-LIST 


EDIT-LIST 


Syntax 


Description 


Available On 


6985-3.2 


EDIT-LIST allows you to edit a saved select-list. 

EDIT-LIST listname 

listname Specifies the name of the select-list to be edited. 

For more information on EDIT-LIST, please refer to the Guide to the 
Ultimate Editors. 

Any user account. 
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EEDIT 


EEDIT 


Syntax 


Description 


Available On 


A 


EEDIT invokes the line editor, with which you can create or edit an 
Ultimate file item. 

Note: EEDIT operates the same as ED {IT}, except that redundant 

blanks and asterisks are compressed from the edited item when 
it is filed. 


EED{IT) filename {itemlist} {(options) 

filename Specifies the name of the file containing the item or items 
to be edited. 


itemlist 


(options 

A 

M 

P 

S 

X 


Specifies one or more explicit item-lDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 


Displays assembly code source programs in standard 
assembly listing format. 

Displays macro expansions when used with the A 
option. 

Routes output to the spooler. 

Suppresses display of line numbers, or suppresses 
display of object code if used with the A option. 

Displays data retrieved from the editor in hexadecimal 
format. 



For more information on EED{IT), please refer to the Guide to the 
Ultimate Editors. 


Any user account. 
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EXCHANGE 


EXCHANGE 

EXCHANGE allows you to switch the names of two items in the same 
file, or to rename a single item. 


Syntax 


EXCHANGE 

filename 

item-lDn 


filename item-lDl item-iD2 

Specifies the file in which to find item-IDl and item-lD2. 
Specifies the names of the items to switch. 


Description EXCHANGE uses the COPY command with the O and D options to 

exchange the names of two specified items, or to rename an item. 
EXCHANGE copies item-IDl to the %TEMP% item, then copies item-ID2 to 
item-IDl, and finally copies %TEMP% to item-lD2 and deletes %TEMP%. 


:EXCHANGE BP PR0G1 PR0G2J 

Exchange names of 

COPY BP PR0G1 PROG2 %TEMP% (0,D) 

PROGl and PROG2. 

%TEMP% PROG1 PROG2_ 


1 PR0G1 


2 PROG2 


3 %TEMP % 


3 items copied 



Available On Any user account. 


See Also copy 
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FILE-SAVE 


FILE-SAVE 

Syntax 

Description 


FILE-SAVE does a full file save. FILE-SAVE saves all file groups to a file- 
save tape, and resets the group-updated flags. 


FILE-SAVE 


FILE-SAVE backs up your database by producing a file-save tape that 
contains your system and user files. FILE-SAVE saves all files and 
items, regardless of activity since the last file-save, except for DX and 
DV files. Also, only the filenames of DY files are saved. 

Note: FILE-SAVE does not save the kernel (coldstart), the ABS 

(assembly language software), or any TCL stacks. 

When invoked, FILE-SAVE attaches tape drive 0 if no tape drive is 
currently attached, and rewinds the tape. It then writes an extra end-of- 
file marker at the beginning of the file-save tape, displays the time, and 
displays the following prompt: 

Do you want the Console listing to go to the printer? 
(Y/N/X)- 

To send the list of files being saved to the printer as well as being 
displayed on the terminal, enter Y. To display the list just on the 
terminal, enter N. To terminate the command, enter X. 

The following prompt is displayed: 

Enter tape block size (500-nnnn) - 

On all IBM systems, and Ultimate 1400 systems with half-inch drives, n 
is 32000. On Ultimate 1400 systems with quarter-inch drives, n is 
31744. On all other systems, n is 8192. Enter the desired tape block 
size. 

The following prompt is displayed: 

Do you want to generate File Statistics? (Y/N) 
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FILE-SAVE 


Available 

See Also 


6985-3.2 


To generate a STAT-FILE item for each saved file, enter Y. Otherwise, 
enter N. The following prompt is displayed: 

Would you like GFEs fixed by the FILE-SAVE process? 
(Y/N) 

Enter Y to let the system fix GFEs by truncating groups at the last good 
item and fixing links if possible. Otherwise, enter N. 

The following prompt is displayed: 

Enter Tape Label - 


Enter the information to be displayed in the tape label. 


:file-saveJ 

Now beginning File-Save Write/Read Test 
WRITE/READ TEST VERIFIED 

File-Save beginning at hh:mm:ss dd mmm yyyy 

Do you want the Console Listing to go to the Printer?(Y/N) NJ 

Enter tape block size (500 - 8192) 8000J 

Do you want to generate File Statistics? (Y/N) YJ 

Would you like GFEs fixed by the FILE-SAVE process? (Y/N) YJ 

Enter Tape label: FILE-SAVEJ 


On FILE-SAVE, SYSPROG, or SECURITY accounts. 


ALL-UPDATE-SAVE 

FILEOPT 

PART-UPDATE-SAVE 

SAVE 

Operations and Maintenance Guide for your specific platform. 

System Management Guide for information on file-save procedures and 
multiple tape operations. 
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FILEOPT 


Syntax 


Description 


FILEOPT displays or modifies a file or account’s file-save options. 


FILEOPT filename {itenilist} {(options) 

filename Specifies the file containing the D-pointers to be 

inspected or updated; can be any file including SYSTEM 
or MD. 


itemlist 


(options 

C 


D 

V 

w 

X 

Y 


Specifies one or more file definition items (D-pointers) 
whose file options are to be displayed or changed, or an 
asterisk (*) to specify all items in the file. Can be 
omitted if a select-list is present. 


Allows BASIC code and saved list pointers in the 
dictionaries; used for compatibility with older software 
revisions (not required on current revision). 

Sets the file code to D (the default) so that the file is 
always file-saved. 

Does not save files unless the V or A option is used with 
SAVE. 

Does not save files when using SAVE with the W option. 

Does not save the file unless the A option is used with 
the SAVE command. 

Saves only the D-pointers in the file. 


Note: If options are omitted, FILEOPT displays the current file-save 
options (attribute I) of each D-pointer. 


Use FILEOPT to display or modify file-save options. It can display or 
modify D-pointers in a file dictionary, user account Master Dictionary, 
or the SYSTEM dictionary. This is an alternative to using ijpdatf.- 
ACCOUNT or UPDATE-FILE to modify the options for a single account or 
file. 
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FILEOPT 


Available 

See Also 


6985-3.2 


If any item in an itemlist is not a D-pointer, the following message is 
displayed: 

[201] 'item 1 is not a file name 

FILEOPT updates each D-pointer with the specified options and displays 
the following message: 

[250] 'filename 1 updated. 

FILEOPT sets a read lock for each group of items, copies the items to 
workspace, then releases the read lock. It then modifies the items and 
writes them back. 


: FILEOPT SYSTEM USERJ 

[251] 'USER' options = DY 


: FILEOPT DICT CUSTOMER CUSTOMER (XJ 

[250] 'CUSTOMER' updated. 


On Any user account. 


UPDATE-ACCOUNT 

UPDATE-FILE 

System Management Guide for information on saves and read locks. 
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FIX-FILE-ERRORS 

FIX-FILE-ERRORS attempts to diagnose the nature of Group Format 
Errors (GFEs) found in a specified file and, if possible, recover the data. 


Syntax 


FIX-FILE-ERRORS filename {(group.no)} {(options} 

filename Specifies the file to be examined. 

(group.no) Specifies one group of the file to be checked for GFEs. 
If omitted, all groups in the file are checked. 

(options 


P Routes output to the spooler. 

X Checks extended item (object code items only). 


Description FIX-FILE-ERRORS processes each group (or the specified group if a 

group.no is indicated) in the file until all groups are examined. 

FIX-FILE-ERRORS assumes that a TSYM file exists in the account of the 
specified file. When possible, the process removes the data in error and 
places it in the TSYM file. These error items are assigned item-IDs 
having the following format: 

Error-type FID Seq# 

Note: When you invoke FIX-FILE-ERRORS, it clears the TSYM file. 

FIX-FILE-ERRORS makes two passes through each group. Pass One 
checks the limits of the primary file space (contiguous frames allocated 
by CREATE-FILE). The number of frames should equal the file’s modulo 
times separation. Errors are displayed in the following format: 

Linkfield error - group at nl - frame n2 

Links: n3 n4 n5 n6 


If the primary space crosses the maximum FID, the program stops and 
issues a message. After processing the primary space, the operation 
scans the links of the extended frames, searching for an incorrect 
backward link and for the end of group. (Extended frames are the 
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FIX-FILE-ERRORS 


Available On 

See Also 

6985-3.2 


linked frames allocated from available space when the primary file space 
is used up.) If an incorrect backward link is found, the program issues 
an error message and scans up to 66 more frames in that group before 
going to the next group. 

Pass Two scans the data one item at a time, examining items for the 
following format errors and making the indicated corrections: 


Error 

Description 

Fix 

Description 

A 

No segment mark at end 

of item. 

1 

A new item is created in the TSYM 

file and a group-terminating segment 
mark is placed after the last good 
item. Any extended frames beyond 

the last item are disconnected from the 

group. 

c 

Count field out of range 
(=>6 and <=32267) 

1 

See above. 

N 

Non-hex character in 

count field. 

1 

See above. 

O 

Premature end of data. 

1 

See above. 

L 

An item-ID exceeds 50 

characters. 

2 

The bad file items are removed and 

placed in the TSYM file. The scan 
continues through the group. 

H 

Item-ID does not hash to 

the current group 

2 

See above. 

(none) 

A segment mark exists 

in the item. 

3 

1 

i 

The segment marks are replaced with 
back-arrows. The message SM @ 
xxxx.yy (where xxxx=frame and 
yy=displacemenl) is displayed. 


When processing is completed, the following message is displayed: 

n new error items created in TSYM 


SYSPROG or SECURITY account. 


System Management Guide for information on Group Format Errors 
(GFEs), and assembler. 
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GET-LIST 

Syntax 

Description 


Available On 

See Also 

2-174 


GET-LIST retrieves a saved select-list for processing. 

GET-LIST {listname} 

listname Specifies the name of the saved select-list. If omitted, a 
null item-ID is assumed. 


Use GET-LIST to retrieve a previously saved list, as an alternative to 
performing a SELECT. 

Note: GET-LIST assumes that a POINTER-FILE (or a Q-pointer to a 
POINTER-FILE) exists in the current account. 

GET-LIST searches the POINTER-FILE for the specified list. If the 
listname is not found, the following message is displayed: 

'listname 1 not on file 


If the listname is found, the following message is displayed: 
n items selected. 

Where n is the number of item-lDs or attributes in the saved select-list. 
The select-list then becomes available to the next system command 
entered or program executed. 


:GET-LIST CUSTOMERJ 

124 items selected. 


Any user account. 


SAVE-LIST 

Ultimate PROC Reference Guide. 

Ultimate RECALL and Ultimate UPDATE User Guide. 
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GROUP 


Syntax 


Description 


GROUP outputs file structure information about the groups in a specified 
file. 


GROUP filename {(options} 


filename Specifies the name of the file to be examined. 


(options 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 

S Suppresses the itemlist, but gives FID (frame ID) and file 

size. 


GROUP provides file structure information about groups, such as the 
physical location of items in groups. This can be used as an aid in 
repairing Group Format Errors (GFEs), since once the location is 
determined, DUMP can be used to view data in the group. 

GROUP outputs the base FID of each group in the specified file. For 
each group, every item-lD in the group is listed, along with a character 
count of the item (in hexadecimal), and its starting address (decimal FID, 
hexadecimal offset). At the end of each group the following statistics are 
displayed: 

n Items m Bytes p/q Frames 

where: 

n Number of items in the group, 

m Total number of bytes used in the group, 

p Number of full frames in the group, 

q Number of bytes used in the last frame of the group. 
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GROUP 


Available On 

See Also 


Information about extended items (items larger than 32K) is placed on 
the line immediately under the primary entry and includes the following 
information: 


• Size (in hexadecimal) of the extended item. 

• Beginning FID (in decimal) of the extended item. 

• Displacement (in hexadecimal) of the beginning of the extended 
item. 


: GROUP USERJ 

880894 

0 9D0 880894.00C USER2 

1 Items 2512 Bytes 5/12 Frames 

880895 

0017 880895. ooc user3 Extended item. 

01E854 1193571.2D 
1 Items 23 Bytes 0/23 Frames 
880896 

003E 880896.OOC USER1 
1 Items 62 Bytes 0/62 Frames 


Any user account. 


DUMP 

ITEM 
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HASH-TEST 


Syntax 


Description 


Available On 


6985-3.2 


HASH-TEST is an Ultimate RECALL command that uses a test modulo to 
provide file management information about a file. 


HASH-TEST filename {itemlist} (sel-criteria) {modifiers} 
{(options) 


filename Specifies the file to be hashed. 

itemlist Specifies one or more explicit item-IDs. If specified, 
each item-lD must be enclosed in single quotes, double 
quotes, or backslashes. If omitted, the command acts on 
the current select-list, or on all items in the file if no 
select-list is present. 


sel-criteria 


Conditions that must be met by an item in order for it to 
be hashed. Also known as a WITH clause. 


modifiers 

(options 

N 

P 

S 


All modifiers valid for LIST or SORT may be used with 
this command. 

Specifies no automatic end-of-page waiting. 

Routes output to the spooler. 

Shows only summary information. 


For further information on HASH-TEST, please refer to the Ultimate 
RECALL and Ultimate UPDATE User Guide. 


Any user account. 
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INIT-NET 


INIT-NET 

Syntax 

Description 

Available On 


2-178 


INIT-NET is an UltiNet® command that initializes your UltiNet 
communication network. 


INIT-NET 


For further information on INIT-NET, please refer to the Ultimate UltiNet 
User's Guide. 


SYSPROG or SECURITY account. 
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ISTAT 


Syntax 


Description 


Available On 


ISTAT is an Ultimate RECALL command that provides file management 
information for a file. 


ISTAT filename {itemlist} {sel-criteria) (modifiers) {(S) 


filename Specifies the file for which information should be 
provided. 


itemlist Specifies one or more explicit item-IDs. If specified, 
each item-lD must be enclosed in single quotes, double 
quotes, or backslashes. If omitted, the command acts on 
the current select-list, or on all items in the file if no 
select-list is present. 

sel-criteria Conditions that must be met by an item in order for it to 
be processed. Also known as a WITH clause. 


modifiers All modifiers valid for LIST or SORT may be used with 
this command. 


(S 


Shows only summary information. 


For further information on ISTAT, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 


Any user account. 
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ITEM 


ITEM 


Syntax 


Description 


ITEM displays structure information for an item in a specified file. 


ITEM filename {itemlist} {(options} 


filename Specifies the file containing the item. 


itemlist 


(options 

N 

P 

S 


Specifies one or more explicit item-IDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 


Specifies no automatic end-of-page waiting. 

Routes output to the spooler. 

Suppresses the itemlist, but gives the frame ID (FID) and 
the group size. 


ITEM outputs the base FID of the group into which the specified itemlist 
hashes. It then lists every item-lD in the group, along with a character 
count of the item (in hexadecimal), and its starting address (decimal FID, 
hexadecimal offset). At the end of the itemlist, the following statistics 
are displayed: 

n Items m bytes p/q Frames 


where: 

n Number of items in the group, 

m Total number of bytes used in the group, 

p Number of full frames in the group, 

q Number of bytes used in the last frame of the group. 


This is followed by the list of items in the group and the statistics for the 
group. Information about extended items (items larger than 32K) is 


r\1 noprl rvn tU* 1 i rva 

^yiuwu vyi i UiV iiiiv 


immediately under the aim inCiUucs me 


following: 

• Size (in hexadecimal) of the extended item. 
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ITEM 


• Beginning FID (in decimal) of the extended item. 

* Displacement (in hexadecimal) of the beginning of the extended item. 

If the item does not exist in the file, the following message is displayed: 

Item Not Found 


: item name longj This is an extended item, 

LONG 

231644 

0025 231644.00C TEST 
0016 231644.031 LONG 

00980A 1279715.2D 

:ITEM MD MULXJ 

MU LX 
211016 

0019 211016.00B *A3 

0016 211016.024 CHARGE-TO 

000B 211016.03A OR 

0011 211016.405 POVF 

0019 211016.056 B/DEL 

001B 211016.06F A4 

0010 211016.087 MULX 

001C 211016.097 S/NAME 

001B 211016.0B3 SSELECT 

001F 211016.0CE V/MAX 

0012 211016.0ED SLEEP 

0021 211016.OFF S 

0018 211016.120 CHECK-SUM 

000A 211016.138 MD 

14 Items 508 Bytes 1/8 Frames 


Available On Any user account. 


See Also dump 

GROUP 
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LAI 00 


LAI 00 

Syntax 

Description 


Available On 

See Also 

2-182 



LAlOO prompts for settings on print quality, characters per inch, pitch, 
lines per inch, and lines per page for DEC letter-quality printers. 


LAlOO 


Before using LAlOO, you must use SP-ASSIGN to route print jobs to the 
proper printer. 

When LAl(X) is invoked, you are prompted for the desired printer 
characteristics. To accept the system default value, press RETURN. 
Default values are: 


Setting Default 

Print quality Draft 

Pitch selection Font 

Characters per inch 10 

Lines per inch 6 

Lines per page 66 


:LAlOOJ 




Enter 

1) Letter Quality or 2) Draft 

Quality print - 

2 J 

Enter 

Pitch Select 1) 

Font Pitch or 

2) All Pitches - 

1J 

Enter 

Characters/Inch 

(5,6,6.6,8.25, 

10,12,13.2,16.5) 

- 12 J 

Enter 

Lines/Inch (2, 3, 

4,6,8, OR 12) 

- 6J 


Enter 

Number of Lines 

per Page - 60J 



v v 


SYSPROG or SECURITY account. 


SP-ASSIGN 
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LEVEL-EXIT 


LEVEL-EXIT returns (pops) you to the previous TCL level after a level 
push, or, if specified, to the primary TCL level. 


Syntax level-exit {all} 

ALL Exits all pushed TCL levels and pops to the primary TCL 

level. If omitted, you are popped back a single TCL 
level. 


Description Use LEVEL-EXIT to pop to a previous level. Levels are pushed from 
TCL or from the system debugger. 

When popping back a level, the screen is updated to appear just as it did 
before the level push was specified. 

LEVEL-EXIT has no effect when EXECUTEd from a BASIC program, but 
can be used in a CHAIN statement. 

If LEVEL-EXIT is entered at the primary TCL level, an error message is 
displayed. 

If SET-LEVEL-PUSH is ON, using LEVEL-EXIT without the ALL parameter 
is the same as pressing the POP function key or <CTRL-0>. LEVEL-EXIT 
has no effect if SET-LEVEL-PUSH is off. 


: : : : LEVEL-EXIT J Pop One TCL level. 

: : : Prompt symbol is reduced by one. 

: : : level-exit allj Return to the primary TCL level. 

: Primary TCL level prompt is displayed. 


Available On Any user account. 

See Also set-level-push 

SHOW-LEVELS 

Chapter 1 of this document for further information on TCL level pushing. 
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LINK-WS 


Syntax 


Description 


LINK-WS links the extended workspace frames of one or more lines. 
Caution: Do not use LINK-WS when other users are on the system. 


LINK-WS {(n} {(n-m} 

n Specifies the line whose extended workspace is to be re¬ 

linked. 

n-m Specifies a range of lines to be re-linked. 

Note: If line number or range of line numbers is omitted, the 

workspaces of all lines are re-linked, except those of lines 
currently logged on and those of the spooler, warmstart, and 
UltiNet processes. 


LINK-WS re-links the extended workspace, which is usually 
automatically linked and available after a file-restore. Each extended 
workspace consists of a contiguous block of frames, divided into three 
equal sections. Each section is 64,000 bytes. 

Use LINK-WS if you suspect extended workspace links have been 
destroyed, for instance, if BASIC' programs abort with the following 
message: 

Not Enough Work Space 


Or, if a program or process aborts on one line but works correctly on 
others. 

LINK-WS performs the linkage process one line at a time. During the 
process, the line number whose workspace is currently being linked is 
displayed on your terminal in hexadecimal. If a specified line is logged 
on, the following message is displayed and the workspace is not 
relinked: 

On! 
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LINK-WS 


Available 

See Also 


6985-3.2 


Note: The extended workspace of the spooler, warmstart, and 
UltiNet processes can only he relinked via a coldstart. 


:LINK-WS (2-4J 

02 On! 

03 04 


On SYSPROG or SECURITY account. 


System Management Guide for information on workspace allocation. 
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LIST 

Syntax 


Description 

Available On 

2-186 


LIST is an Ultimate RECALL command that generates formatted output of 
selected items and attributes in a file. 


LIST filename {itemlist} {sel-criteria} {output-specifications 
{print-limiters}} {{options} 


filename 

itemlist 


sel-criteria 


Specifies the file for which information should be listed. 

Specifies one or more explicit item-IDs. If specified, 
each item-ID must be enclosed in single quotes, 
double quotes, or backslashes. If omitted, the 
command acts on the current select-list, or on all 
items in the file if no select-list is present. 

Conditions that must be met by an item in order for 
it to be listed. Also known as a WITH clause. 


output- Specifies the attributes and values in the 

specifications selected items that should be listed. 


print-limiters 

(options 

C 

D 

H 

I 

N 

P 


Restricts the printing of output specification to 
values that meet the limit conditions. 

Suppresses column heading lines that define 
attributes in a report. 

Suppresses all detail lines from a report. 

Suppresses the report’s page heading line and "n 
items listed" line. 

Suppresses the item-ID column or row heading. 
Specifies no automatic end-of-page waiting. 
Routes output to the spooler. 


For further information on LIST, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 


Any user account. 
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LIST-FILE-STATS 

LIST-FILE-STATS lists the current file statistics for the system. 

Syntax list-file-stats 

Description LIST-FILE-STATS produces a current File Statistics Report that reflects all 
files on the system at the latest full file-save. 

When invoked, LIST-FILE-STATS displays the following prompt: 

To Lineprinter? (Y/N/X) - 

Enter Y to send the report to the printer, N for screen display, or X to 
exit to TCL. If you enter Y or N, the following prompt is displayed: 

Detail Suppress? (Y/N/X) - 

Enter X to return to TCL. If you enter Y, the report is limited to the 
following information for each account: 


USER-NAME 

The account name. 

SIZE 

Total size of the account in bytes. 

FRAMES 

Total number of frames used by the account. 

%UT 

Utilization of file space. 

PAD 

Pad space in file. 

INDEXES 

File indexes. 

GFE 

Group Format Errors. 


At the end of the listing is a total for each column. 

Note: For columnar display when the report is sent to the terminal, 
set terminal width with the 132 command. 

If you enter N, every file is listed alphabetically within its user account. 
The following information is displayed for each file: 
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LIST-FILE-STATS 


R# 

Tape reel number. 

SEQ 

File number. 

NAME 

File name. One or more fields are present, indicating the 
file is an account, a dictionary, or a data file. 

BASE 

Base FID of file. 

MOD 

Modulo of file. 

SEP 

Separation of file. 

SIZE 

Bytes in file. 

ITEMS 

Number of items in the file. 

FRAMES 

Number of frames used by the file. 

AV/ITM 

Average bytes per item. 

ITM/GP 

Average items per group. 

FRM/GP 

Average frames per group. 

%UT 

Utilization of file space. 

PAD 

Pad space in file. 

INDEXES 

Number of file indexes. 

GFE 

Group Format Errors. 


A total for each column is shown at the end of each account. 

Note: The file-restore process clears STAT-FILE, which contains the 
LIST- Ft LE -S'l ’A 7 S data. If you need to list the file status after a 
file-restore, use the LOAD-STATS command to restore the 
appropriate STAT-FILE. 
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12: 

22:34 09 MAR 1991 










page 

1 

* * 

***** FILE 

S T A T I 

S T I 

C S REPO 

R T 

* * * * 

* * * 






R# 

SEQ NAME. 

. BASE 

MOD 

SEP .SIZE_ 

ITEMS 

FRAMES 

AV/ITM 

ITM/GP 

FRM/GP 

%UT. 

...PAD... 

INDEXES GFE 

1 

1176 AB.SYS 

770176 

3 

1 57 

2 

3 

28 

0.6 

1.0 

3 

1, 443 

0 

1 

1178 AB.SYS*AB.SYS 

771670 

1 

1 77 

20 

8 

44 

1.2 

1.0 

5 

3, 112 

0 

1 

1051 BUS.CUST 

762247 

1 

1 50,145 

31 

101 

1, 617 

31.0 

101.0 

99 

355 

0 

1 

1052 BUS.CUST*BUS. 

CUST 762248 

17 

1 80,072 

420 

170 

190 

24.7 

10.0 

94 

4, 928 

0 

1 

1311 ZCF 

587010 

3 

1 35 

1 

3 

35 

0.3 

1.0 

2 

1, 465 

0 

1 

1312 ZCF*ZCF 

685407 

2833 

1 1, 906,497 

42543 

5343 

44 

15.0 

1.8 

71 

765, 003 

0 

1 

1310 ZIP.CODE 

586942 

29 

1 12,674 

337 

42 

37 

11.6 

1.4 

60 

8, 326 

0 


** TOTALS FOR USER- 

ZIP.CODE 


























1,919,206 


5388 




71 

774,794 

0 





20,956,042 


78876 




78 

7,481,958 

0 


Available On sysprog or security account. 


See Also account-save 

FILE-SAVE 

LOAD-STATS 

SAVE 

Operations and Maintenance Guide for your specific platform. 

System Management Guide for information on the File Statistics Report. 
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LIST-GFE 


LIST-GFE 

Syntax 

Description 


2-190 


LIST-GFE checks the SYSTEM-ERRORS file for Group Format Error 
(GFE) records, compiles any GFE information, and outputs the results to 
the terminal or printer. 


LIST-GFE 


LIST-GFE first checks the SYSTEM-ERRORS file for any GFE records. If 
none exist, the following message is displayed: 

[401] No items present. 

There are no GFE records logged in the SYSTEM-ERRORS 
file. 

<CR> to continue 


Press RETURN to go to the TCL prompt. 


If GFE errors do exist in the SYSTEM-ERRORS file, the following 
message is displayed: 

There are n GFE records logged in the SYSTEM-ERRORS 
file 

Enter "P" to send listing to Printer, <CR> to screen 

Enter a P to send the GFE report to the printer, or press RETURN to 
display the report on the screen. 

LIST-GFE then begins to process the selected GFE error records against 
the STAT-FILE. An asterisk (*) is displayed on the screen (regardless of 
the output selection) for each 20 STAT-FILE items processed. All GFEs 
that can be associated with a particular file are listed first. Any GFEs for 
which no file can be found are listed separately. 


The report is then directed to either the terminal or printer as specified. 


All records 2TC d Ut O ITUl 11C d 1 ly 


included on reports directed to the printer. 


For reports on the terminal, each record is individually displayed and 
you are prompted to continue or quit after each display. 
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Available 

See Also 

6985-3.2 


: LIST-GFEJ 

There are 4 GFE records logged in the SYSTEM-ERRORS file 

Enter "P" to send listing to Printer, <CR> to screen 
Output being displayed on terminal 

Each displayed indicates that 20 records in the STAT-FILE 

have been processed 
********************** 


GFE Recorded on 26 MAY 1991 at 12:48AM 

GFE located at 82730.132 in group with primary frame 61231 


Account= SALES 

Diet filename= BP,SALES 


STAT-FILE Key= 2:399 
File Base= 61229 

Mod= 29 

Sep= 1 

<CR> to continue, "Q" to 


quit 




The current STAT-FILE does not contain a file with a base for 
the following GFE 1 s 


DATE 


TIME 

LOCATION 

PRIMARY FRAME 

FILE BASE 

17 

JAN 

90 

05:41PM 

128343 . 

128343 

128293 

28 

MAR 

90 

06:21PM 

129666 . 

129666 

129652 

29 

MAR 

90 

10:21AM 

82730.132 

61231 

61228 


<CR> to continue 


On SYSPROG or SECURITY account. 


FILE-SAVE 

LIST-SYSTEM-ERRORS 

SAVE 

System Management Guide for information on the File Statistics Report. 
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LIST-INDEX 


Syntax 


Description 


2-192 


LOCKS 


LIST-INDEX-LOCKS lists the lock status for each index associated with a 
specified file. 


LIST-INDEX-LOCKS filename {(options} 

filename Specifies the file for which index locks are to be listed. 

(options 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 


The system locks an index as follows: 

• If an index is being read by a user, it is locked against being 
updated; however, it can be read by other users. 

• If an index is being updated by a user, it is locked against being read 
or updated by all other users. 

LIST-INDEX-LOCKS displays the following information: 


ATTR# 

INDEX-L 

WRITE 


Attribute number. A negative attribute number indicates 
that the index is a generated value based on a correlative. 

Displays the line number of a user currently setting the 
overall Index-Lock for that attribute. 

Displays the line number of a user currently updating the 
index. 


READ-CTR. Displays the current number of users accessing (reading) 
the index. 
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Available 

See Also 


:LIST-INDEX-LOCKS VENDORJ 


Attr# 

Index-L Write 

Read-ctr. 


2 

37 

0 

User on line 37 is updating 

-0001 

0 

information for the index on 

1 

- 4 

attribute 2. 


Four users are accessing 
information from the 
index based on attribute 1. 


On Any user account. 


CLEAR-INDEX-LOCKS 

LIST-INDEXES 
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LIST-INDEXES 

LIST-INDEXES lists all indexes for a specified file. 

Syntax LIST-INDEXES filename {(options) 

filename Specifies the file for which indexes are to be listed. 

(options 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 


Description Use LIST-INDEXES to list the indexes associated with a file. When 

invoked, LIST-INDEXES displays the index structure and the name of the 
Ultimate UPDATE definition item specified in CREATE-INDEX. 

If no indexes exist for the file, the following error message is displayed: 

No Indexes Present 

If an index is corrupted, it is not used by the system and the following 
message is displayed: 

Index 1 name 1 is corrupted. Please delete and recreate it. 


:LIST-INDEXES 

Indexes for file 

Attr# Attr.name 

VENDORJ 

: VENDOR 

Correlative 

Attr . 

Just . 

Id's 

Just. 

Multi- 

Value 

0 cs 

A;(2:",":3) 

L 

R 

N 

1 NAME 


L 

R 

Y 

2 ZIP.CODE 


L 

R 

N 


Available On Any user account. 

See Also create-index 

DELETE-INDEX 
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LIST-ITEM 


Syntax 


Description 


Available On 


6985-3.2 


LIST-ITEM is an Ultimate RECALL command that lists the contents of 
items in a specified file in Line Editor format. 


LIST-ITEM filename {itemlist} {sel-criteria} {(options} 


filename Specifies the file containing the items to be listed. 

itemlist Specifies one or more explicit item-lDs. If specified, 

each item-lD must be enclosed in single quotes, double 
quotes, or backslashes. If omitted, the command acts on 
the current select-list, or on all items in the file if no 
select-list is present. 


sel-criteria 

(options 

A 

F 

I 

N 

P 

S 

X 


Conditions that must be met by an item in order for it to 
be listed. Also known as a WITH clause. 

Lists items in editor assembler format. 

Formfeeds after each item. 

Suppresses the item-ID column or row heading. 
Specifies no automatic end-of-page waiting. 

Routes output to the spooler. 

Suppresses line numbers. 

Displays data in hexadecimal format. 


For more information on LIST-ITEM, please refer to the Ultimate 
RECALL and Ultimate UPDATE User Guide. 


Any user account. 
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LIST-LABEL 


Syntax 


Description 

Available On 

2-196 


V 


LIST-LABEL is an Ultimate RECALL command that generates formatted 
output of data from items in a file. Item data can be grouped into 
blocks, with several blocks placed across the page, as in a set of mailing 
labels. LIST-LABEL is similar to LIST, except that more than one item 
can exist on an output line. 


LIST-LABEL filename {iteinlist} {sel-criteria} {output- 
specifications {print-limiters}} {(options} 


filename 


Specifies the file for which labels should be 
listed. 


itemlist Specifies one or more explicit item-IDs. If 

specified, each item-lD must be enclosed in single 
quotes, double quotes, or backslashes. If 
omitted, the command acts on the current select- 
list, or on all items in the file if no select-list is 
present. 

sel-criteria Conditions that must be met by an item in order 

for it to be listed. Also known as a WITH clause. 


output- Specifies the attributes and values in the 

specifications selected items that should be listed. 


print-limiters Restricts the printing of output specification to 
values that meet the limit conditions. 

(options 

C Suppresses column heading lines that define 

attributes in a report. 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 



k.,. 


For further information on LIST-LABEL, please refer to the Ultimate 
RECALL and Ultimate UPDATE User Guide. 


Any user account. 
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LIST-LOCKS 


Syntax 


Description 


LIST-LOCKS displays information about currently set group locks, item 
locks, and read locks. 

LIST-LOCKS {(options} 

(options 

I Displays item lock information. 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 

Note: If options are omitted, all group lock information is displayed. 


Use LIST-LOCKS to determine if any group, item, or read locks are 
currently set, and if so, the line numbers (and UltiNet system numbers) 
that set them. 

Group and item locks are set by the system when files are updated. 

Item locks can also be set by BASIC statements such as READU. A 
group can be locked, items in a group can be locked, or a group and 
items can be locked. A read lock, which locks groups, is set by the 
system when items are accessed. 

If no locks are set, LIST-LOCKS takes no action and returns to TCL. If 
any locks are set, the following display is generated for each group (or 
specified group): 

DecimalFID (HexFID) LINE/* [UltiNet#/*] <readlocks> 
(LINE) {[UltiNet#/0]} 


where: 

DecimalFID 

(HexFID) 

LINE/* 

[UltiNet#/*] 


Starting FID address of the group in decimal. 

Hexadecimal FID of the group. 

Line number for a group lock, or * if group is 
not locked. 

UltiNet system number, or * if the local system. 
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Available On 

See Also 


2-198 


<readlocks> Line numbers having read locks set. Line 

numbers are displayed in the order set, with the 
most recently set line number first. 

Within a group, the following display is generated for each item lock: 

{LINE} Line number of group having an item lock. This 

is only displayed if the I option is entered. 

[UltiNet#/0] UltiNet system number, or 0 if the local system. 

This is only displayed if the I option is entered. 


: LIST - LOCKSJ 

232874 (38DAA) 

* [*] <14 20 5> 

Lines 14, 20, and 5 have set 
read locks for the group in 
frame 232874. There are no 
group locks set. 

232853 (389D5) 

4 [*] <10> 

Line 10 has set a read lock for 



the group in frame 232853, 
and Line 4 has a group lock 



set. 

:LIST-LOCKS 

(u 


242233 (3B239) 

* [*] 

Line 4 has an item locked in 

4 [0] 


the group. 


SYSPROG or SECURITY account. 


System Management Guide for information on group locks, item locks, 
and read locks. 


€ 

V*. 
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LIST-NAMED-COMMON 


LIST-NAMED-COMMON lists the BASIC named COMMON areas for the 
current line. 


Syntax list-named-common 

Description LIST-NAMED-COMMON lists the named COMMON areas for the current 

line. If no named COMMON areas exist for the current line, no message 
is displayed. 


:LIST-NAMED-COMMONJ 

/ctr/ The current line has one named COMMON 

area called CTR. 


( 


Available On Any user account. 


See Also 


Ultimate BASIC Language Reference Guide for information on COMMON 
areas. 
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LIST-PLOT 


Syntax 


Description 


2-200 


DEVICES 

LIST-PLOT-DEVICES lists all terminals and printers supported by 
UltiPlot. 




list-plot-devices {(p} 

(P Routes output to the spooler. 

LIST-PLOT-DEVICES lists the terminals and printers that can produce 
UltiPlot output (bar or line graph, scatter diagram, and rectangular or pie 
chart). 

When LIST-PLOT-DEVICES is invoked, the following information is 
displayed: 

Device.. Manufacturer... Model.. Resolution Notes. 

where: 

Device Name of the printer or terminal. 

Manufacturer Name of the manufacturer. 

Model Model number. 

Resolution Resolution specifications in pixels. 

Notes Miscellaneous information. 



t 
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NOTE 

The following device type is fully qualified and supported by Ultimate for 
use with UltiPlot: 

PTX Printronix Printer 

Ultimate cannot guarantee that any other device will work with UltiPlot. 


Some serial printers use null cn 
The spooler on all PICK systems 
control codes. When this occurs 
pieces of lines to the right. 


aractors as spaces when in graphics mode, 
aods extra null characters after certain 
, gaps will appear in the graph shifting 


To prevent this, the printer must be started by a terminal without any 
delay characters as defined by the term setting. If the printer is already 
started, delete it ( SP-DELETELPTR n). Before starting the printer, execute 
TERM ,,,0,0 then start the printer'. 

Press <RETURN> to continue: 


Available On sysprog or security account. 


See Also 


UltiPlot Reference Guide. 
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LIST-SYSTEM-ERRORS 

LIST-SYSTEM-ERRORS lists disk, memory, and other errors recorded in 
the SYSTEM-ERRORS file. 


Syntax list-system-errors 

Description Use LIST-SYSTEM-ERRORS periodically to examine the SYSTEM- 

ERRORS file. Early detection of errors can prevent future serious 
problems with disk drives, memory boards, or other hardware 
components. The following types of errors are reported: 

• Illegal MLCP channel errors detected by the kernel (Ultimate Bull 
6000/7000 hardware only). 

• Disk errors. 

• Error Detection and Correction (EDAC)-corrected memory errors 
detected by the disk controller and the CPU. (Ultimate Bull 
6000/7000 Only.) 

• On Ultimate 1400 systems only, machine-check errors (address or 
bus exceptions). 

• Group Format Errors (GFEs). Use LIST-GFE to get detailed 
information about the GFEs. 

• Virtual aborts. 

When LIST-SYSTEM-ERRORS is invoked, the following prompt is 
displayed: 

To the Printer (Y=<CR>/N) ? 

To send the report to the printer, enter Y or RETURN. To display the 
report on the screen, enter N. (Since the printed report contains fields 
not included on the screen display, and since the diversity of 
information presented makes the screen display difficult to interpret, 
Ultimate recommends that you print the report.) The following prompt 
is displayed: 

System Error listing explanation (Y/N=<CR>) ? 
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LIST-S YS TEM-ERRORS 


To see the System Error Reporting and Interpretation document at the 
end of the error listing, enter Y; otherwise, enter N or press RETURN 

The following prompt is displayed: 

Would you like the list sorted (Y/N) ? 

It is recommended that you sort the report by error type; enter Y to do 
so. 


If no system errors have been logged to the SYSTEM-ERRORS file, the 

following message is displayed: 

[401] No items present. 

If there are errors, they are either printed or displayed on your terminal. 

Most errors are explained in the System Error Reporting and 

Interpretation document at the end of the error listing. Other error 

information includes: 

« The display of machine-check errors on Ultimate 1400 systems 
includes the columns TIME, DATE, type of exception, and PC, ADR, 
and PIB values. 

• The printout of machine-check errors on Ultimate 1400 systems 
includes address registers (R0-R15), various physical 68000 
registers, and other internal state information to be used for 
diagnostic purposes. 

• The display or printing of Group Format Errors (GFEs) includes 
time, date, FID/DISP, BASE, and GROUP. 

• The display of aborts includes date, time, line numbers, and abort 
type. 
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: LIST-SYSTEM-ERRORSJ 

To the Printer (Y=<CR>/N) ?NJ 

System Error listing explanation (Y/N=<CR>) ?NJ 
Would you like the list sorted (Y/N) ?YJ 

9 items selected 


TIME 1 

DATE 

STAT 

STAT 

CHAN 

DRIVE 

ERROR 

PLATTER 

CYL HD SEC 



1 

2 

# 

# 

CODE 

SELECT 

(IN DECIMAL) 








BIT 


11:42:17 

.01/02/90 

23 

RC 

0880 

MLCP 

ERROR 



14:05:51 

01/07/90 

8040 

8000 

0600 

00 

0 

584 5 

40 

13:41:38 

01/17/90 

8040 

8000 

0600 

00 

0 

580 5 

40 

10:58:34 

01/20/90 

8040 

8000 

0600 

00 

0 

580 5 

40 

11:34:33 

01/26/90 

23 

RC 

08 80 

MLCP 

ERROR 



14:55:15 

02/17/90 

23 

TR 

1400 

MLCP 

ERROR 



16:40:56 

02/17/90 

30 

MD 


EDAC 

ERROR 

DETECTED 

BY DISK 

16:41:05 

02/17/90 

132 



# OF 

EDAC ERRORS DETECTED BY CPU 


GFE:16:50:29 03/01/90 506677 506706 


,|T\ 


Available On sysprog or security account. 



See Also list-gfe 

SYSTEM-ERROR-SUMMARY 

SYSTEMERRORS 

System Management Guide for information on system error reporting. 
Troubleshooting section of Operations and Maintenance Guide. 



2-204 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


6985-3.2 




LIST-UERRORS 


LIST-UERRORS 

LIST-UERRORS reports the results of the most recent UPD-VALIDATE, 
which validates Ultimate UPDATE dictionary definition items for a file. 

Syntax list-uerrors filename {lptr} {(p) 

filename Specifies the file for which dictionary validation results 
are to be reported. 

LPTR Routes output to the spooler. 

(P Same as LPTR. 

Description For further information on LIST-UERRORS, please refer to the Ultimate 
RECALL and Ultimate UPDATE User Guide. 

Available On Any user account. 
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LIST-UITEMS 

LIST-UITEMS reports the Ultimate UPDATE dictionary definition items in 
a file. 


Syntax list-utems 

Description For further information on LIST-UITEMS, please refer to the Ultimate 

RECALL and Ultimate UPDATE User Guide. 

Available On Any user account. 
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LIST-VSAVE 


Syntax 


Description 


STATS 

LIST-VSAVE-STATS generates a report based on the VSAVE-STATS file 
created by the last VERIFY-SAVE. 


LIST-VSAVE-STATS {LPTR} {132} 

132 Puts terminal in 132-column mode. 

LPTR Routes output to the spooler. 


LIST-VSAVE-STATS generates the Verify Save Statistics Report, which 
contains a summary of the information on the file-save tape. This report 
is similar to the File Statistics Report, which is generated by the file- 
save process and stored in the STAT-FILE file. 

In addition, LIST-VSAVE-STATS compares the information in the STAT- 
FILE currently on the system with the information in the VSAVE-STATS 
file, and indicates any differences on the report. The information 
displayed includes: 

• Reel number 

• File number 

• Account name( *dictname {{*dataname}} 

• Number of items in file on tape, as determined by VERIFY-SAVE 

• Number of bytes in file on tape, as determined by VERIFY-SAVE 

• Number of items in file on disk, as determined from STAT-FILE 

• Number of bytes in file on disk, as determined from STAT-FILE 

• Number of item-size errors 

• Number of tape format errors 

• Number of BASIC object item errors 

If the information on tape (as defined in the VERIFY-SAVE file) differs 
from the information on disk (as defined in the STAT-FILE file), the 
Verify Save Statistics Report flags item-size errors, tape formats errors, 
and object item errors. If the number of items or bytes on tape differs 
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LIST-VSAVE-STATS 


2-208 


from the number on disk, an asterisk is appended to the display of the 
number on disk. 

Item-size and BASIC object item errors are flagged when the number of 
bytes in an item does not match the number that precedes the item. 

Item-size errors indicate possible data loss in items. Before you make 
another file-save tape, look at the item with the error. Is this a critical 
item? Is it worthwhile to redo the file-save for this error? If so, redo 
your file-save. If not, consider doing a T-DUMP to save the item 
separately. 

Object item errors indicate possible data loss with BASIC object items. 
You might want to recompile the object code and try again. You could 
also do a T-DUMP or AC'COUNT-SAVE. 

Tape format errors are flagged when the tape does not satisfy the 
acceptable Ultimate tape format. Tape format errors indicate possible 
problems with the way information is written to the tape. If you get a 
tape format error, redo the file-save with another tape or perform system 
maintenance such as cleaning the tape drives and tape heads. 

After trying the above suggestions, use the VERIFY-SAVE and LIST- 
VSAVE-STATS commands again. If there are still errors, use another 
tape to do your file-save. If the new tape does not correct this problem, 
call Ultimate TAC. 

Caution: The above guidelines are suggestions only. It is possible 

to encounter situations not addressed here. 

The following is a sample of the first page of the printed report. In this 
example, there is one item size error and one tape format error for the 
files in the ACE account. 


rA 
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14:49:34 03 JAN 1991 PAGE 1 

****VERIFY SAVE STATISTICS REPORT**** 


REEL# FILE# Acc name*Dict name*Data name... Tape items Tape size Slat-File items Stat-File size ISIZE TFMT.. OBJ.. 


1 

46 ACE 

519 

25223 

519 

25221* 

1 

0 

0 

1 

57 ACE*C.INTERFACE 

9 

342 

9 

342 

0 

0 

0 

1 

58 ACE*C.1NTERFACE*C.INTERFACE 

0 

0 

0 

0 

0 

0 

0 

1 

51 ACE*CALENDAR 

7 

311 

7 

311 

0 

0 

0 

1 

52 ACE*CALENDAR*CALENDAR 

0 

0 

0 

0 

0 

0 

0 

1 

85 ACE*DOCKETING 

36 

1372 

36 

1372 

0 

0 

0 

1 

86 ACE* DOCKETING* DOCKETING 

74 

7626 

74 

7626 

0 

1 

0 

1 

53 ACE*DOCKETING.BP 

1 

41 

1 

41 

0 

0 

0 

1 

89 ACE*DOCKETING.BP*DOCKETING.BP 

9 

322 

9 

322 

0 

0 

0 


1 

69 ACE*SPECIAL.MENUS 

17 

625 

17 

625 

0 

0 

0 

1 

70 ACE*SPECLAL.MENUS*SPECIAL.MENUS 

56 

22226 

56 

22226 

0 

0 

0 

1 

87 ACE*TERM.BP 

27 

1340 

27 

1340 

0 

0 

0 

1 

88 ACE*C.INTERFACE 

27 

64712 

27 

64712 

0 

0 

0 

*** 

TOTALS FOR USER - ACE 

2912466 


2912464 

1 

1 

0 


Available On sysprog or security account. 


See Also verify-save 
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LISTACC 


LISTACC 


Syntax 


Description 


LISTACC lists accounting data of system usage for specified accounts 
and line numbers. 


LISTACC {accountname#n} {LPTR} {NOPAGE} 

accountname#n Specifies name and line number of the account 
for which data should be listed. Line number 
must be preceded with a pound sign (#). Use 
spaces to separate multiple accountnames. If 
omitted, all accounting history items in the ACC 
file are listed. 

LPTR Routes output to the spooler. 

NOPAGE Specifies no end-of-page waiting. 


LISTACC displays account information contained in the ACC file. The 
ACC file stores usage information on accounts that selected the 
Accounting Option during CREATE-ACCOUNT or UPDATE-ACCOUNT. 

When invoked, LISTACC displays the following information on selected 
accounts in the ACC file: 


ACC. DATE. TIME... CONN... UNITS PAGES 

where: 

ACC User account name and line number separated by a 

pound sign (#). 

DATE Date logged on the system. 

TIME Time logged on the system. 

CONN Connect time. The number of hours and minutes 
between logon and logoff. 

UNITS CPU usage. 

PAGES Number of pages routed to the spooler. 
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:LISTACC SYSPROG#23 SYSPROG#33J 


PAGE 1 



10 : 

15:04 

19 MAR 1991 

ACC. 

. . . DATE. 

TIME... 

CONN... 

UNITS 

PAGES 



★ 

* 

★ 

* 

SYSPROG#23 

03/12 

18:36 

05 :29 

152 

34 


03/13 

17:59 

02:32 

204 



03/16 

17:23 

00:27 

1 



03/17 

18 :19 

01:48 

35 


SYSPROG#33 

03/16 

09:34 

00:03 

02 



2 items listed 


Available On Any user account. 


See Also charge-units 

CHARGES 

CLEAR-ACC-FILE 

CREATE-ACCOUNT 

UPDATE-ACCOUNT 

System Management Guide for information on the Accounting History 
(ACC) file and user accounts. 
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LISTCONN 


LISTCONN 

Syntax 

Description 


Available On 

See Also 

2-212 


ij 


LISTCONN lists all Ultimate RECALL connectives in a specified file’s 
dictionary. 


LISTCONN {filename} {LPTR} {NOPAGE} 


filename 


LPTR 

NOPAGE 


Specifies the file containing connectives to be listed. If 
omitted, the account's Master Dictionary is assumed. 

Routes output to the spooler. 

Specifies no automatic end-of-page waiting. 


Connectives are elements in Ultimate RECALL statements that are used in 
specifying selection-criteria, sort-criteria, and display parameters, and C 
as the first character of attribute one. 

In the following Ultimate RECALL statement, WITH, >, BY, and BREAK- 
ON are connectives: 

SORT TOOL.FILE WITH COST > 100 BY MANUF BREAK-ON MODEL 


:LISTCONNJ 


PAGE 1 


time date 

M/DICT... 

*A1. 

If a filename is specified, it is 
displayed in place of M/DICT. 

BY-EXP-DI 

sc- 


BY-EXP 

c. 


BY-DSND 

c/ 


THE 

cz 


68 items 

listed. 



Any user account. 


Ultimate RECALL and Ultimate UPDATE User Guide. 
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LISTDICT 

LISTDICT lists the attribute definitions of a file’s dictionary items. 

Syntax listdict {filename} {lptr} {nopage} 

filename Specifies the file whose dictionary is to be examined. If 
omitted, the account’s Master Dictionary is assumed. 

NOPAGE Specifies no automatic end-of-page waiting. 

LPTR Routes output to the spooler. 

Description When LISTDICT is invoked, the following attribute definition 
information is listed: 

filename File whose dictionary is to be examined. The 

Master Dictionary is shown as M/DICT. 

item-lD Attribute name. 

CODE Attribute definition type: 

A = Attribute definition. 

X = Protected attribute. 

U = Ultimate UPDATE attribute definition. 

A/AMC Attribute number. The number or position of the 

attribute in the data item. 

S/NAME Col umn heading for Ultimate RECALL reports. 

S/AM C Structure code if the attribute controls or is 

controlled by other attributes. 

CONVERSIONS Conversion code for items such as date, time, 
money, pattern-matching, and range checks. 

CORRELATIVES Correlative code, used for special functions such 
as computations. 

TP Justification of the attribute field. 

R= Right-justified. 

L= Left-justified. 
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LISTDICT 


Available 

See Also 

2-214 


T= Text-justified (wraparound on blank). 
U= Unconditional left justified. 

MAX Maximum column width. 


:LISTDICTJ 

PAGE 1 12:24:55 26 OCT 1991 

M/DICT : *A0 
CODE A 
A/AMC 00 
TP L 
MAX 10 

M/DICT : *A9DV 
CODE A 
A/AMC 0 

CONVERSIONS MR%%% 

CORRELATIVES F; 12;NV;"1";- 
TP T 
MAX 3 


5 items listed. 


: listdict inventory lptrj Partial 132-column 

printout is shown below. 


PAGE 1 

INVENTORY. CODE A/AMC 
CONVERSIONS.. 


MANUFACTUREA 1 
DESCRIPTIONA 2 
QUANTITY A 3 
LIST.PRICE A 4 
EXT.PRICE A 5 


S/NAME. 

MANUFACTURER 
DESCRIPTION 
QUANTITY 
LIST PRICE 
EXTENDED PRICE 


S/AMC 


MR2 $, 
MR2$, 


On Any user account. 


Ultimate RECALL and Ultimate UPDATE User Guide for information on 
attribute definition items. 
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LISTF 


LISTF sorts and lists all file definition items (D-pointers) in a file’s 
dictionary. 


Syntax listf {dict filename} {lptr} {nopage} 

filename Specifies the file whose dictionary is to be examined. If 
omitted, the file definition items in the current Master 
Dictionary are displayed. 

LPTR Routes output to the spooler. 

NOPAGE Specifies no automatic end-of-page waiting. 


Description 


When LISTF is invoked, the following information is displayed: 
name File or account name. 

CODE File definition code (D, DC, DV, DW, DX, DY, DZ). 
F/B ASE File location (first frame ID in primary storage). 
F/MOD Modulo (number of groups in primary storage). 
F/S EP Separation (number of frames per group). 


:LISTFJ 

PAGE 1 

*** m/dict *** 

FILE DEFINING ITEMS 

05 

JUN 1991 

M/DICT.. 

CODE F/BASE.. 

. F/MOD. 


F/SEP... 

BP 

D 

1247822 

1 

1 

NEWAC 

D 

78026 

1 

1 


Available On Any user account. 

See Also listfiles 
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LISTFILES 


Syntax 


Description 


'vV 


LISTFILES sorts and lists all file definition items (D-pointers) and file 
synonym definition items (Q-pointers) in a dictionary. It displays data 
filenames indented under their associated dictionary filenames. 


LISTFILES {filename} {LPTR} {nopage} {(options) 


filename 

LPTR 

NOPAGE 

(options 

F 

o 


Specifies the file whose dictionary is to be listed. If 
omitted, the default is the account’s Master Dictionary. 

Routes output to the spooler. 

Specifies no automatic end-of-page waiting. 


Displays File Control Block (FCB) FID. 

Specifies the old method. Displays only the dictionary 
level information, which was the format in revisions 
prior to 190. 

Same as LPTR. 


Note: If parameters are omitted, files, Q-pointers, and data sections 

in the current account's Master Dictionary are displayed. 



When invoked, LISTFILES displays the following information: 

Files for: filename time date Page n 

File Code Base Mod Sep Hash 

DICT FILENAME 
DATA FILENAME 

where: 

filename The specified filename. If omitted, the current account 
name is assumed. 



2-216 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


6985 - 3.2 


LISTFILES 


file 

Lists dictionary filenames and data filenames; the data 
filenames are indented under their associated dictionary 
filenames. 

Code 

File definition code (D-pointer or Q-pointer). 

Base 

File location (first frame ID in the primary storage 
block). 

Mod 

Modulo (number of groups in primary storage). 

Sep 

Separation (number of frames per group in primary 
storage). 

Hash 

Hashing algorithm (1 or 2) is used to hash the items into 
groups of storage. 


: lxstfiles J Lists files in the current account. 


Files for: 

SYSPROG 

10:36:59 

19 MAR 

1991 

Page 

File 

Code 

Base 

Mod 

Sep 

Hash 

CONVERSION 

D 

82726 

1 

1 

1 

DOC 

D 

82728 

1 

1 

1 

PGM 

D 

82758 

3 

1 

1 

PROC 

D 

82818 

7 

1 

1 

TABLE 

D 

82815 

1 

1 

1 

NEW AC 

D 

81812 

1 

1 

1 

NEWAC 

D 

81814 

17 

1 

1 


Available On Any user account. 


See Also listf 
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LISTPROCS 


LISTPROCS sorts and lists all PROCs in a file or dictionary. 


Syntax listprocs {filename} {lptr} {nopage} 

filename Specifies the file whose PROCs are to be listed. If 
omitted, the PROCLIB fde is displayed. 

LPTR Routes output to the spooler. 

NOPAGE Specifies no automatic end-of-page waiting. 


Description 


When invoked without parameters, LISTPROCS produces a list similar to 
the following: 


:LISTPROCSJ 


PAGE 

1 

13:53:44 

20 APR 1991 

PROCLIB : 

ADD.DEL.INDEX 


Line 

1 

PQ 


Line 

2 

C 7738 56107 MUR 


Line 

3 

C UPD 


Line 

4 

C 


Line 

5 

HRUN SYSLIB LAST.NAME H.FILE 

(U 

Line 

6 

P 


Line 

7 

HRUNUPDATE PROCLIB ADD.DEL.INDEX 

Line 

8 

H (FLNC) 


Line 

9 

P 


Line 

10 

X 


PROCLIB 

ASORT 



Available On Any user account. 


See Also LISTVERBS 

Ultimate PROC Reference Guide. 
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LISTU{SERS} 


LISTU(SERS} lists the account name, line number, and time of logon for 
all current users. 


Syntax listihsersj 


Description When invoked, LISTUfSERS) displays the following infoimation: 

CH#. PCBFID NAME. TIME.. DATE. LOCATION 

where: 

CH# User's line number. An asterisk is displayed to the left 

of the line issuing the command. 

PCBFID Process Control Block FID. The first frame of the 

workspace for the process or CH#; frame is shown in 
hexadecimal. 

NAME Account name. 

TIME Time the account logged on. 

DATE Date the account logged on. 

LOCATION Name and phone extension of the line's user. This 
information can be changed with the TERMINAL 
command. 


: LISTUJ 






CH# . 

PCBFID 

NAME. 

.. TIME.. 

DATE. 

.LOCATION.... 


*001 

0840 

SYSPROG 

09:00 

03/19/91 

JOE SMITH 

x22 

002 

0880 

CUSTOMER 

08:13 

03/19/91 

JIM BRANDT 

x2 8 

028 

0F00 

SCHEDULE 

10:35 

03/19/91 

RECEPTIONIST 

x29 

040 

1200 

INVENTORY 

09:33 

03/19/91 

PEG WHARTON 

x30 


Available On Any user account. 

See Also terminal 

System Management Guide for information on the DICT ACC file. 
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LISTVERBS 

LISTVERBS sorts and lists all verbs in the specified dictionary. 

Syntax LISTVERBS {filename} {LPTR} {NOPAGE} 

filename Specifies the file whose dictionary is to be listed. If 
omitted, the Master Dictionary (MD) is assumed. 

LPTR Routes output to the spooler. 

NOPAGE Specifies no automatic end-of-page waiting. 

Description LISTVERBS lists system commands and cataloged programs, but does 
not list PROCs. 


:LISTVERBSJ 





PAGE 7 




17:03:50 

19 MAR 1991 

M/DICT... 

*A1 . . . . 

. . . *A2 .... 

.. *A3.. 

.... *A4.. 

. *A5... 

DROP-RTS 

P 

618A 




DTR 

P 

10A0 




DTX 

P 

10A0 




DUMP 

PZ 

42 




EBASIC 

p 

2 

4011 

BE 

UP 

ECHO-OFF 

p 

118B 





Available On Any user account. 

See Also listprocs 
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LOAD-STATS 


LOAD-STATS restores the contents of the STAT-FILE from a file-save tape 
and lists the results. 


Syntax load-stats 

Description FILE-SAVE saves the contents of the STAT-FILE at the end of the file-save 

tape or disk that it creates. This information is useful in: 

• Determining the order of accounts and files on the corresponding 
file-save. 

• Determining if files need to be reallocated. 

« Determining reallocation parameters. 

• Repairing Group Format Errors (GFEs). 

LOAD-STATS clears the current STAT-FILE, restores the contents of the 
STAT-FILE from the file-save tape, and executes LIST-FILE-STATS to 
print a report. 

On a multiple tape drive system, attach the correct drive with the T-ATT 
command before LOAD-STATS is executed. 

LOAD-STATS displays the following messages: 

This procedure will load the STAT-FILE from a file- 
save tape and then list the file-stats to the printer 
Mount the last reel of your file-save and press <CR>: 

Mount the last reel of the file-save that contains the desired STAT-FILE, 
and bring it to load point. Then press RETURN to begin loading the 
STAT-FILE file from the tape. 
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LOAD-STATS 


Available 

See Also 


2-222 


:LOAD-STATSJ 

This procedure will load the STAT-FILE from a file-save 
tape and then list the file-stats to the printer 
Mount the last reel of your file-save and press <CR>:J 
Tape attached 
Block size: 8000 
Block size: 8000 


File Statistics Report 
To Lineprinter? (Y/N/X) - YJ 

Detail Suppress? (Y/N/X) - NJ 

Now generating statistics report 


On SYSPROG account. 


FILE-SAVE 

LIST-FILE-STATS 
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LOAD-TERMDEF 

LOAD-TERMDEF loads the terminal definitions (in the file TERMDEF) for 
the system. LOAD-TERMDEF should be run after modifying an entry in 
the TERMDEF file for that change to take effect. This program is used 
by the coldstart procedure. 

For further information on LOAD-TERMDEF, please refer to the System 
Management Guide. 
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LOCK-FRAME 

LOCK-FRAME locks a frame in memory. 

Caution: Locking too many frames at one time reduces the amount 

of memory available for accessing programs and data fdes. 

Syntax lock-frame n 

n Specifies the decimal number of the frame to be locked. 


Description LOCK-FRAME should be used only by qualified personnel to lock a 
frame in memory. LOCK-FRAME is not required in a normal 
environment because the operating system locks frames in memory 
when necessary. 

LOCK-FRAME converts the specified number of the frame to be locked 
and returns the absolute hexadecimal address of the memory buffer in 
which the frame is memory locked. 

When you lock a frame, the following message is displayed: 

[11] Frame locked at location X'a' 

where 'a' is the absolute hexadecimal address of the memory buffer in 
which the frame is locked. 

A memory-locked frame remains locked until it is released by a 
powerfail restart, COLDSTART, UNLOCK-FRAME, WARMSTART, or 
WARMSTOP. 


: LOCK-FRAME 39440J 

[11] Frame locked at location X'030D00' 


Available On sysprog or security account. 

See Also unlock-frame 

WARMSTART 

WARMSTOP 
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LOG 

Syntax 

Description 


LOG displays a menu to provide transaction logging functions on the 
terminal issuing the command. The terminal is then dedicated to logging 
until the transaction logger is exited. 


LOG 

Use LOG to start the transaction logger, to select the accounts and files to 
be logged, and to print the list of accounts and files to be logged. 

The transaction logger considers a transaction to be one of the following 
updates: 

• Creating an item, file, or account. 

• Updating an item, file, or account. 

• Clearing an item, file, or account. 

• Deleting an item, file, or account. 

Transaction logging can be used in conjunction with update file-saves to 
prevent data loss in case of a system failure. 

Only one line at a time can be used for transaction logging. The logger 
terminal should be used sparingly for operator input since the same 
workspace is used for logging and the operator-system dialogue. 
Ultimate recommends using any line except line 0 (zero) for transaction 
logging, since line 0 is used by the system console to boot the system 
and to perform other system functions. 

Note: Mount a new reel of tape before each logging session. 

When LOG is invoked (from SYSPROG), the Logger Main Menu screen 
is displayed: 
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LOG 


SYSPROG 


Logger Menu 


09:21:46 08 OCT 1991 


1. 

LOG Menu 


2. 

Selective 

Setup 

3. 

Selective 

Touchup 

4. 

Selective 

Report 


Enter program selection or press <CR> to exit 


if ■ 


Enter one of the four choices: 

• The Log Menu is used to check logger status, start or stop the 
logger, start or stop the logging tape, or change logging parameters. 

• Selective Setup is used to turn logging of the entire system on or 
off, or turn logging of specific accounts or files on or off. 

• Selective Touchup is used to selectively set transaction logging 
indicators on individual files in the system. 

• Selective Report outputs a report of current or future transaction v j 

logger settings. 

Or press RETURN to return to TCL. 

Note : All accounts are initially set for no logging. 


LOG Menu Option 1 of the Logger Main Menu, LOG Menu, displays the following 

screen: 
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LOG 


6985-3.2 


-. 

Logger status: Inactive 

Transaction logger options: 

1. Activate logger; start tape 

2. Deactivate logger; exit menu 

3. Suspend tape 

4. Restart tape 

5. Change tape attachment parameters 

, Enter option or <CR> to display status: , 


To display the current status, press RETURN. A status screen similar to 
the following is displayed: 


-N 

Tape started; seq# 0003 

Logger assigned to line 2 

Disk queue permanent frames used: 5 

Disk queue overflow frames used: 0 

Latest transaction in disk queue: 1 time date 

Oldest transaction# in disk queue: 2 ? ? 

V_ ) 


The first line of this status screen is the Logger Status Line, which 
shows sequencing information. The first three values are a count of 
file-save activity, while the fourth value is a count of Transaction 
Logger activity. This number is incremented by 1 each time you select 
the Activate Logger or Restart Tape options explained below. This 
number is reset to zero when a SYS-GEN or file-restore is performed. 

To return to the LOG Menu from this screen, press RETURN. Options 1 
through 5 of the LOG Menu are explained below. When one of these 
options is selected, the logger performs the requested operation, if 
possible, then prints a response and redisplays the current status and the 
LOG Menu. 
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1. Activate Logger; start tape 

Option 1 of the LOG Menu activates the logger and starts tape operation 
for a new transaction logging session. A transaction tape must already 
be mounted and loaded at the BOT mark. The status of the logger must 
be Inactive; otherwise a warning message is displayed and the logger 
remains in its current state. When the logger is activated, it writes a 
sequencing information segment to tape to signal a new session. 

If more than one reel of tape is needed during a session, the following 
message is displayed: 

Mount reel #n 

Label: Transaction Log 

(C)ontinue/(Q)uit 

Mount a new reel of tape as soon as possible, since all transactions are 
recorded on disk until the new reel is ready, and a system failure in the 
interim would lose those transactions. 

All reels from a single session are known as a transaction session tape 
set. 


2. Deactivate logger; exit menu 

Option 2 of the LOG Menu exits the LOG Menu immediately if the logger 
is inactive. If the logger is active and a tape is started, any transactions 
queued on disk are flushed to tape and a tape EOF mark is written to 
signal the end of the session. The frames used by the logger are 
released to the system pool of available space, the logger is exited, and 
control returns to TCL. 

If the status of the logger is Tape Suspended (see below), the following 
message is displayed: 

Any transactions now queued on disk will be lost. 

Continue (Y/N)? 

Enter Y to exit the logger without flushing the queue; any frames are 
released to overflow. Enter N to return to Tape Suspended state. 
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3. Suspend tape 

Option 3 of the LOG Menu ends the current logging session. 

Transactions queued on disk are flushed to tape, an EOF mark is written, 
and the tape is suspended. 

The tape drive is detached so that the tape can be removed and a 
different tape can be loaded for other purposes (such as T-DUMPor T- 
LOAD). During the time the tape is suspended, transactions are recorded 
on disk. 

When the tape drive is ready to resume transaction logging, mount a 
new reel of tape and select option 4 below. 

Note: Do not suspend the tape for long, since: 

• If a failure occurs, all transactions stored on disk but not yet written 
to tape are lost. 

• Overflow frames are used to store the transactions and if the system 
is low on disk space, performance can be affected. 

4. Restart tape 

Option 4 of the LOG Menu starts a new transaction logging session on a 
new reel of mounted tape. A sequencing information segment is written 
to the BOT, then all transactions currently queued on disk are dumped to 
the new tape. 

If the current status is not Tape Suspended when this option is entered, a 
warning message is displayed and the logger remains in its original state. 

5. Change tape attachment parameters 

Option 5 of the LOG Menu lets you change T-ATT parameters (block size 
and tape drive number). This option can be selected if the current state is 
Inactive or Tape Suspended, The logger prompts for the new T-ATT 
options. Enter the new parameters, or press <CR> to retain the old 
parameters. The logger automatically uses the standard default options 
(Tape drive 0 and Block size 4000) if options are omitted. 
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Option 2 of the Logger Main Menu, Selective Setup, lets you turn 
logging of the entire system on or off, or turn logging of specific 
accounts or files on or off. 

Note: Selective Setup sets logging indicators for specified accounts 
and files, except accounts and files that have a DICODE of DX 
or DY. These items are never subject to logging, and neither 
Selective Setup nor Selective Touchup will set their indicators 
to require logging. 

Transaction logging settings entered during Selective Setup remain in 
effect until you change them. You can change them by either using the 
Selective Setup option again, or by using the Selective Touchup option. 
Selective Touchup is faster because it makes only minor changes in the 
original settings. 

When Selective Setup is chosen from the Logger Main Menu, the 
following message is displayed: 

WARNING : The SET-UP program will reset any previously 
set flags. 

Do you want to continue (Y/N) 

To exit this option and return to the Logger Main Menu, enter N. To 
continue with setup, enter Y. If you enter Y, the following screen is 
displayed: 


— 

SELECT TRANSACTION LOGGER PARAMETERS 

1. Set Current Parameters 

2. Set Future Parameters 

3. Set BOTH Current and Future Parameters 

The future parameter becomes the Current parameter 
during a File-Restore. 

ENTER OPTION: 

V_ ) 


Current parameters are the accounts and files to be logged for the current 
session. Future parameters replace the current parameters during a file- 
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restore, which allows time-consuming resetting to take place while 
logging is in process, without disturbing the current logging. 

Note : Use option 3, Set BOTH Current and Future Parameters, for 

the initial setting. 

After an option is selected from the logging parameters screen above, 
the following screen is displayed: 


Enter 1 or 2 to specify system default value 

1. Log ALL accounts. 

2. Log NO accounts. 

3. Set LOGGING for an Account. 

4. Reset Logging for an Account. 

ENTER OPTION: 

_ J 


Each option on this menu is described below: 

1. Log ALL accounts, and 

2. Log NO accounts 

To log transactions for all accounts or for no accounts on the system, 
enter 1 or 2. As logging is activated or deactivated for each account, 
the following message is displayed: 

Processing: SYSTEM, accountname 

Number of FIRST Level D-POINTERS in accountname is nnn 
Processing File: accountname, filename 

After one of the above system-wide indicators is set, the following 
screen is displayed to let you specify any accounts that will be 
exceptions to the system-wide setting: 
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— 

SELECT TRANSACTION LOGGER PARAMETERS 


SYSTEM Logging parameter is (NO) LOGGING 

1. Change the setting for one or more accounts. 

2. Exit without changing the setting. 

ENTER OPTION: 

_ J 

To exit this screen and return to the previous screen, enter 2. To change 
the log/no log setting for one or more accounts, enter 1. The following 
screen is displayed: 

— 

SELECT TRANSACTION LOGGER PARAMETERS 

The system is set for (NO) LOGGING. Select those 
accounts that should (NOT) be LOGGED. 

1. Process the account listed below. 

2. Display the next account (in alphabetical order). 

3. Exit without selecting any more accounts. 

To select a specific account, enter the account name 
and press <CR>. 

ACCOUNT = accountname 

___ / 

To select the accountname displayed at the prompt, enter 1. The 
logging status (on or off) for the specified account is changed to its 
opposite. 

To display the name of the next account without selecting the current 
account, enter 2. 

To select a specific account, enter the name of the account at the prompt. 
If you enter a name that is not found in the SYSTEM file, the following 
message is displayed: 

ACCOUNT IS NOT A VALID SYSTEM LEVEL FILE - TRY AGAIN 
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To exit this screen, enter 3. The following screen is displayed: 


— 

System and account logging parameters have been set. 

1. Select a specific file. 

2. Exit without selecting specific files. 

ENTER OPTION: 

V_/ 


To end the program, enter 2. To select specific files to set logging 
status opposite of what their account status is, enter 1. The following 
account selection screen is displayed: 


-. 

Select the account that contains the file whose 
logging parameter is to be changed. 

1. Select the account listed below. 

2. Display the next account (in alphabetical order). 

3. Exit without selecting any more accounts. 

To select a specific account, enter the account name 
and press <CR>. 

ACCOUNT = accountname 

v___ J 


To exit the account selection screen and return to the Logger Menu, 
enter 3. To select the accountname displayed at the prompt, enter 1. To 
display the name of the next account without selecting the current 
account, enter 2. To select a specific account, enter the name of the 
account. 

Once an account is selected, the following file selection screen is 
displayed: 
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- \ 

accountname is set for (NO) LOGGING 

Specify only files for that should (NOT) be LOGGED 
Names of Q-Pointer items are not valid 

1. Select the file listed below. 

2. Display the next filename (in alphabetical order). 

3. Exit without selecting any more files. 

FILE NAME = filename 

V_ ) 


To change the setting for the filename displayed, enter 1. The indicator 
is changed and the next filename is displayed. 

To display the name of the next file without selecting the current name, 
enter 2. To select a specific file, enter the name of the file. 

To exit the file selection screen and return to the account selection 
screen, enter 3. 

3. Set (turn on) LOGGING for an Account, and 

4. Reset (turn off) LOGGING for an Account 

To turn logging on or off for one or more accounts, enter 3 or 4. The 
following screen is displayed: 


s. 

SELECT TRANSACTION LOGGER PARAMETERS 

1. Process the account listed below. 

2. Display the next account (in alphabetical order). 

3. Exit without selecting any more accounts. 

To select a specific account, enter the account name 
and press <CR>. 

ACCOUNT = accountname 

_ J 
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To select the accountname displayed at the prompt, enter 1. The 
logging status (on or off) for the specified account is changed to its 
opposite. 

To display the name of the next account without selecting the current 
account, enter 2. 

To select a specific account, enter the name of the account at the prompt. 
If you enter a name that is not found in the SYSTEM file, the following 
message is displayed: 

ACCOUNT IS NOT A VALID SYSTEM LEVEL FILE - TRY AGAIN 

To exit this screen and return to the Logger Menu, enter 3. 


Option 3 of the Logger Main Menu, Selective Touchup, selectively sets 
transaction logging indicators on individual files in the system. Its 
purpose is to make minor changes in file settings after the Selective 
Setup option has been used at least once. Selective Touchup does not 
interrupt any currently active transaction logging. 

Note: You cannot use Selective Touchup to change the logging 

settings for the SYSTEM file, or for any Master Dictionary 
files. To change the settings for these files, you must use the 
Selective Setup option. 

When the Selective Touchup option is selected from the Logger Main 
Menu, the following screen is displayed: 
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-. 

TRANSACTION LOGGER-TOUCHUP 

Use this program to select files whose transaction 
logger status you want to change. 

You may only change the logging status of Dictionary 
(level 2) files and Data (level 3) files. You cannot 
change the logging status of the SYSTEM file or of the 
Master Dictionaries. 

1. Change the Current status. 

2. Change the Future status. 

3. Change BOTH the Current and Future status. 

ENTER OPTION: 

V_/ 


w 


To exit this screen and return to the Logger Menu, press RETURN. 

If the new parameters should take effect immediately, enter 1. 

If the new parameters should take effect after the next file-save and file- 
restore procedures, enter 2. 

If logging parameters for BOTH current and future sessions should be 
set, enter 3. 

If 1, 2, or 3 is entered, the following file selection screen is displayed: 


-\ 

This program will modify the current logging status of 
a file only under some conditions. It will always 
allow a file to be set to "no logging" . However, it 
will not allow a file to be set to "logging" if the 
Transaction Logger is currently active - since the 
data would not be properly handled. 

Enter "ACCOUNTNAME FILENAME" for the file whose status 
is to be modified. 

^Enter name: 
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To exit this screen without changing the status of a file, press RETURN. 

To change the logging status of a file, enter its accountname and 
filename. 

Once the accountname and filename are entered, the following log/no 
log file screen is displayed: 

-\ 

1. LOG the filename file 

2. DO NOT LOG the filename file 

ENTER OPTION: 

_ 


To turn on logging of the file, enter 1. To turn off logging of the file, 
enter 2. 

The file's status is changed. The following prompt is displayed in order 
to enter the name of another file in the same account: 

Enter filename: 


To change the logging status of another file in the current account, enter 
the filename. To change a file in a different account, press RETURN; 
the prompt to specify accountname is redisplayed. Repeat these steps 
for each file whose status should be changed. 

To return to the Transaction Logger Touchup Menu when you are 
finished changing the logging status of your files, press RETURN at the 
Enter name: prompt. 


Option 4 of the Logger Main Menu, Selective Report, outputs a report 
of current or future transaction logger settings. 

When the Selective Report option is selected, the following screen is 
displayed: 
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PRINT A TRANSACTION LOGGER REPORT 

1. Print a report on Current settings 

2. Print a report on Future settings 

The Future setting is made the current setting 
during a file restore. 

^ENTER OPTION:_ j 



To print a report on current settings, enter 1. To print a report on future 
settings, enter 2. Once an entry is made, the following message is 
displayed at the bottom of the screen: 

PROCESSING ACCOUNT : accountname 
FILE : filename 


The completed report is sent to the spooler for output to the printer 
assigned to the current line. The Logger Main Menu screen is 

redisplayed. /" n 

The following information is displayed in the report: 

• The first part is the setting for the system as a whole. 

• The second part is the listing of accounts that are set opposite to the 
system as a whole. 

• The third part is the listing of files within accounts where the files 
are set opposite to the accounts in which they reside. 

A sample report format is shown below. 
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Available 

See Also 


TRANSACTION LOGGER REPORT Time Date Page 1 
TRANSACTION LOGGER REPORT OF CURRENTLY ACTIVE FILES 
SYSTEM IS SET FOR NOT LOGGING 

ACCOUNTS WHICH ARE EXCEPTIONS (WHICH ARE SET FOR LOGGING) 
FOLLOW: 

(accountname) IS TO BE LOGGED 


(accountname)-A SYSTEM LEVEL FILE OR ACCOUNT IS TO BE LOGGED 
(filename)-A DICTIONARY FILE, AND ITS SUBORDINATE DATA FILE(S) 
ARE NOT TO BE LOGGED 

(filename)-A DICTIONARY FILE, AND ITS SUBORDINATE DATA FILE(S) 
ARE NOT TO BE LOGGED 


END OF REPORT 


On SYSPROG or SECURITY account. 


LOG-STATUS 

LOGGER 

System Management Guide for information on transaction logging, file 
backup and restore. 
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LOG-STATUS 


LOG-STATUS displays the transaction logger status. 


Syntax log-status 

Description The transaction logger is a utility that records disk file updates onto 
magnetic tape as the updates are made. At any given time, the logger 
can be in one of the following states: 

Inactive No logging is currently being performed. If the 

logger is inactive, the LOG-STATUS command 
displays the message: 

[777] The transaction logger is 
inactive. 

Tape started If the logger is active, and logging transactions to 
tape has been started, the LOG-STATUS command 
displays the message: 

[779] The transaction logger is active. 

Tape suspended If the logger is active, and logging transactions to 
tape has started but is now suspended, the LOG- 
STATUS command displays the message: 

[778] The transaction logger has been 
suspended. 

Available On Any user account. 

See Also log 

LOGGER 

System Management Guide for information on the transaction logger. 
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LOGGER 

Syntax 

Description 


Available On 

See Also 


LOGGER is used by LOG to display the transaction logger status and 
Logger Menu. 


LOGGER 


LOGGER status can be active, inactive, or suspended. 


:LOGGER J 


Logger status: status 



Transaction logge 

r options: 

1. 

Activate logger; start 

tape 

2 . 

Deactivate logger; exit 

menu 

3 . 

Suspend tape 


4 . 

Restart tape 


5. 

Change tape attachment 

parameters 


Enter option or <CR> 

to display status: 


SYSPROG or SECURITY account. 


LOG 

LOG-STATUS 

System Management Guide for information on the transaction logger. 


6985 - 3.2 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


2-241 



LOGOFF 


LOGOFF 


Syntax 


Description 


2-242 


A 

V 


LOGOFF ends a specified terminal session on another line and logs off 
the line. 

Caution: LOGOFF can cause data to be lost, depending on the 

activity on the specified line. 


LOGOFF {line} {(options) 


line Specifies the line or lines to be logged off. Line can be: 

n Log off line n. 

n-m Log off lines n through m, inclusive. 

n, n-m Log off a single line and a range of 

lines. Can be any combination of single 
lines and ranges, with each separated by a 
comma or a space. 

If omitted, the system prompts for line number. 

(options 

t Specifies number of seconds to wait for the logoff to 

complete; default is 20 seconds, maximum is 60 
seconds. 0 (zero) posts a logoff condition to the 
specified line and immediately returns to the line issuing 
the command. 

S Suppresses all terminal output on the line to be logged 

off until the LOGON message is displayed. 

U Untraps a trapped process and then logs off the line. If 

omitted, trapped lines are not logged off and a message 
to that effect is displayed on the terminal of the line 
issuing the LOGOFF. 






Use LOGOFF to end the processing on and log off another line. LOGOFF 
is similar to pressing the <BREAK> key and entering OFF at the 
debugger prompt in that it interrupts whatever processing was going on; 
however, the specified line is logged off only when it is safe to do so. 
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For example, if the line is in the middle of updating a file, LOGOFF waits 
until the update is complete. This allows lines to be logged off from a 
remote terminal without causing GFEs or corrupting system data 
structures such as the table of available space. 

If parameters are omitted, the following prompt is displayed: 

Enter processes and (options) : 

Enter the line number or numbers of the processes to log off. 

Note : To avoid problems with LOGOFF during execution of a BASIC 
program, include the TRAP ON or BREAK OFF statement in the 
program. The BASIC BREAK OFF statement can be overridden, 
however, by entering the TCL BREAK-KEY-ON command for 
the specified line. In this case, LOGOFF must be entered again. 

When the logoff is complete, a message similar to the following is 
displayed: 

[534] Successful logoff of process : n 

If the number of seconds to wait for logoff is exceeded, a message 
similar to the following is displayed: 

[577] Logoff posted for process : n 
In this case, the line is logged off as soon as possible. 


On SYSPROG or SECURITY account. 


BREAK-KEY-OFF 

BREAK-KEY-ON 

COFF 

DROP-DTR 

OFF 

RAISE-DTR 

RESET-LOGOFF 

SET-LOGOFF 

BASIC Reference Manual, TRAP ON topic. 

System Management Guide for logoff procedures. 
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Syntax 


Description 


LOGON logs on a specified line and starts a terminal session. 

LOGON {n{-m},accountname{,password}} {(options} 

n Logs on line n. 

n-m Logs on lines n through m, inclusive. 

accountname Specifies the name of the account to which line or 
lines are logged. 

password Specifies the password for the specified account. 

(options 

t Specifies the number of seconds to wait for the 

logon to complete; default is 20 seconds, 
maximum is 60 seconds. 0 (zero) posts a logon 
condition to the specified line and immediately 
returns to the line issuing the command. 

S Suppresses all terminal output to and input from 

the line to be logged on, until the line is logged 
on. This option is useful for running 
background jobs without a terminal. 

U Untraps a trapped process and then logs on the 

line. If omitted, trapped lines are not logged on 
and a message to that effect is displayed on the 
terminal of the line issuing the LOGON. 

Note: If all parameters are omitted, the system prompts for them. 


Enter the line number or numbers, account name, and password, if any, 
to log on. When the logon is complete, a message similar to the 
following is displayed: 

[533] Successful logon of process : n 
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If the number of seconds to wait for logon is exceeded, a message 
similar to the following is displayed: 

[574] Logon posted for process : n 
The line is logged on as soon as possible. 


Available On sysprog or security account. 

See Also logto 
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LOGTO 

Syntax 

Description 


Available On 

See Also 


LOGTO allows you to log to a different account from the current account. 


LOGTO accountnamef,password} 

accountname Specifies the name of the account to log to. 

password Specifies the password, if any, for the specified 

account. If entered as part of the command, the 
password will be displayed in your TCL stack. If 
omitted, the system will prompt for it. 


To log off the current account and log to another account, enter the name 
of the account to log to. 

Note: LOGTO cannot be executed from a secondary TCL level. 

Once the system accepts the account name and password, you are 
logged off the current account. The system then updates the accounting 
statistics for the logged off account and displays them as follows: 

CConnect time= n mins.; CPU= m units, lptr pages =x > 
where: 

n Number of minutes logged on to the account. 

m Number of units charged to the account. 

x Number of pages printed to the line printer from the 

account. 

When logging to another account, all spooler assignment options (see 
SP-ASSIGN) are cancelled. All tape attachments are maintained. 


Any user account. 


CHARGE-TO 

OFF 
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LOOP-ON 


Syntax 


Description 


LOOP-ON executes a TCL command statement until a stop condition 
occurs. 


LOOP-ON statement {C /} {L/} {n/} {s/} 

statement Specifies any valid TCL statement, including parameters 
and options. 

Note: The following LOOP-ON parameters can be entered anywhere 

in the syntax line, and are not passed to TCL: 

C / Clears the screen before each execution. 

L/ Causes a blank line to be printed before each execution. 

More than one L/ can be specified. 

n/ Specifies a 1- or 2-digit number specifying seconds to 

pause between each execution. The default is no pause 
except for terminal type F (IBM 3270), in which case 
pause is 1 second. (It is not usually possible to press 
<BREAK> and enter END on a 3270 unless a pause is 
specified.) 

S/ Suppresses printing the TCL command. 


Use LOOP-ON for debugging and system diagnostic purposes, usually 
with simple system commands such as WHO or WHERE. It allows 
system engineers to monitor a change in the line-to-terminal connection 
while a line is active, but without losing data in an actual job process. 

LOOP-ON repeats the specified command until one of the following stop 
conditions occurs: 

• The <BREAK> key is pressed and END is entered at the system 
debugger prompt. 

• The TCL command is a PROC. In this case, LOOP-ON is only 
executed once. 
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Available 

See Also 
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• The TCL command runs a BASIC program that executes the ABORT 
statement. 

• The line is logged off because of a drop in Data Set Ready (DSR). 

• The LOGOFF command is executed for the line executing the LOOP- 
ON. 


: LOOP-ON WHO 2 L/ 3/J 

Execute the WHO 2 command 


every three seconds, with a blank 


line before each execution. 

WHO 2 


2 SYSPROG 


WHO 2 


2 SYSPROG 


WHO 2 


2 SYSPROG 



On Any user account. 


BREAK-KEY-OFF 

BREAK-KEY-ON 

LOGOFF 

SET-LOGOFF 
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MEM.DIAGS 


MEM.DIAGS is used by the ON-LINE-DIAGS command to perform 
diagnostics on computer memory. Ultimate recommends that you use 
the ON-LINE-DIAGS command to run diagnostic tests. 

For further information on MEM.DIAGS, please refer to ON-LINE-DIAGS. 
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Syntax 


Description 


Available On 




MESSAGE allows one user to send a message to one or more users on 
the same Ultimate system. 


MESSAGE {!}receiver message-text 

! Indicates receiver (see below) is a line number 

rather than an accountname. Line numbers do 
not have to be logged on to be specified. 

receiver If not preceded by an exclamation point (!), 

specifies an accountname to which the message is 
to be sent; the account must currently be logged 
on. If preceded by an exclamation point, 
specifies a line number to which the message 
should be sent. The line need not be logged on. 

message-text Specifies the message to be sent. 

For further information on MESSAGE, see MSG listed alphabetically in 

this chapter. 


Any user account. 
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MLIST 


Syntax 


Description 


MUST lists specified items in an assembly language program. 


MLIST filename {itenilist} {(options) 


filename Specifies the program file from which the items listed in 
the itemlist are to be accessed and listed. 


itemlist 


(options 

n-m 


E 


J 


M 

N 

P 


S 


Specifies one or more explicit item-IDs, or an asterisk (*) 
to indicate all items in the file. Can be omitted if a select- 
list is present. 


Lists only line numbers n through m, inclusive. 

Produces an errors-only listing. 

Enables page eject if an EJECT directive is in the program 
being listed. 

Prints macro expansions of the source statements. 
Specifies no automatic end-of-page waiting. 

Routes output to the spooler. 

Suppresses display of the object code. 


Use MLIST to get a listing from a file of assembly language programs. 
MLIST generates a program listing that includes one instruction per line. 
Each line shows the following information: 

• A statement number. 

• Location counter. 

• Object code and source code, with the label, op-code, operand and 
comment fields aligned. 

A page heading is also displayed at the top of each new page. 

Errors, if any, are displayed in the location counter/object code area. 
Macro expansions are displayed as source code, with the operation 
codes prefixed by a plus sign (+). 
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See Also 
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:MLIST 

USER-MODES ENT443 (1-10)J 


PAGE 1 

ENT443 FRAME 419 

14:37:45 12 

MAR 1991 

001 0001 

7FF301A3 FRAME 419 


! oooi 

002 

*USER 


003 

*01 DEC 1991 


004 

*R10*180 


005 

*30 JUN 1991 


006 

*SCOTT 


007 0001 

1E0A 


008 0003 

1E0D 


009 0005 

1E10 


010 0007 

1E13 


EOI 


On SYSPROG or SECURITY account. 


Ultimate Assembly Language Reference Guide. 
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Syntax 


Description 


MLOAD loads an assembly language program mode (item) into the frame 
specified in the mode’s FRAME operation code statement. 


MLOAD filename {itemlist} {(options} 

filename Specifies the file from which the items (modes) listed in 
itemlist are to be accessed and loaded. 


itemlist Specifies one or more explicit item-lDs, or an asterisk (*) 
to indicate all items in the file. Can be omitted if a select- 
list is present. 

(options 

E Prints messages relating only to errors. 

I Prints item-IDs if more than one is loaded. 

N Inhibits load but prints message. 


P Routes output to the spooler. 


Use MLOAD to load an assembled program or mode into a frame 
specified by a FRAME operation code statement. The assembled mode 
must fit in one frame. A FRAME statement must be the first statement 
assembled in the mode. 

If the load is successful, the program becomes part of the ABS software 
and the following message is displayed: 

[216] Mode ' itemlD' loaded; Frame =nnnn Size =sss Cksum =cccc 

where: 

nnnn Four-digit decimal number of the frame into which the 
mode has been loaded. 

sss Number of bytes of object code loaded into the frame, 

expressed in hexadecimal (base=16). 

cccc Byte checksum for the object code in the loaded mode. 
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MLOAD 


Available 

See Also 


2-254 


: MLOAD USER-MODES CALC2J 

[216] Mode 'CALC2' loaded; Frame = 400 Size = 1DB Cksum = B18C 


On SYSPROG or SECURITY account. 


AS 

ASM 

MVERIFY 

OPT 

Ultimate Assembly Language Reference Guide. 
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MOVE 


Syntax 


6985-3.2 


FILE 


MOVE-FILE moves a file from one account to another. 


MOVE-FILE {filename} {FROM acctname} {TO acctname} {(Q} 

filename Specifies the name of the file to be moved. If 

omitted, the system prompts for it. The filename 
cannot already exist in the destination account, 
unless it is a Q-pointer to the source file. 

FROM acctname Specifies the name of the account from which the 
file should be moved; also known as the source 
account. If specified, the FROM keyword is 
required. If omitted, the current account is 
assumed. 

TO acctname Specifies the name of the account to which the 

file should be moved; also known as the 
destination account. If specified, the TO 
keyword is required. If omitted, the current 
account is assumed. 

Note: If both FROM and TO accountname are omitted, the system 
prompts for both. 

(Q Changes the file's Q-pointers in all accounts to 

the account where the file was moved. An 
asterisk is printed on the screen as each account 
containing a Q-pointer to the file is updated. You 
must have access to SYSTEM dictionary, and to 
the accounts containing Q-pointers to the moved 
file in order for those Q-pointers to be updated. 

Note: Updating Q-pointers can take a long time since the entire 
system must be searched. 
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MOVE-FILE 


Description MOVE-FILE allows you to move a file from one account and place it in 

another account. You must have access to both accounts in order to use 
MOVE-FILE. The filename, FROM accountname, and TO accountname 
can be specified in any order. 

After the move, the filename in the source account is replaced with a Q- 
pointer to the file in the destination account. When the move is 
completed, a message similar to the following is displayed: 

[434] File 1 A 1 moved from account , B I to f C f 


:MOVE-FILE 

PRICES FROM ADMIN (QJ 

Moves file PRICES from 
the ADMIN account to the 
current account, and 
updates all accessible Q- 
pointers to PRICES. 

: MOVE-FILE 

PAYROLL TO ADMINJ 

Moves file PAYROLL from 
the current account to the 
ADMIN account. No Q- 
pointers are updated. 

:MOVE-FILE 

FROM ADMIN TO MAINJ 

The system will prompt 
for the filename; the file is 
moved from the ADMIN to 
the MAIN account. No Q- 
pointers are updated. 

:MOVE-FILE 

(QJ 

The system prompts for 
input as follows: 

Enter Source Account Name: 


Enter Destination Account Name: 


Enter File 

Name: 

All accessible Q-pointers 
to the file are updated. 


Available On Any user account with privilege level 1 or greater. 
See Also copy 

COPY-FILE 
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MSG 


Syntax 


Description 


6985-3.2 


MSG allows one user to send a message to one or more users on the 
same Ultimate system. 

MSG is the same as MESSAGE. 


MSG {!}receiver message-text 

! Indicates receiver (see below) is a line number 

rather than an accountname. Line numbers do 
not have to be logged on to be specified. 

receiver If not preceded by an exclamation point (!), 

specifies an accountname to which the message is 
to be sent; the account must currently be logged 
on. If preceded by an exclamation point, 
specifies a line number to which the message 
should be sent. The line need not be logged on. 
To send to all users, enter an asterisk (*). 

message-text Specifies the message to be sent. 


Use MSG for inter-office communications, or to inform users of 
impending system activities. MSG attempts to send the message to the 
specified account or line. All users logged on to a specified 
accountname receive the message. 


To send the message to all logged on accounts, enter an asterisk for the 
receiver parameter. To send the message to all lines (whether logged 
on or not), enter an exclamation point followed by an asterisk (!*). You 
must have privilege level 2 to do this. 

The following information is displayed on the receiving terminals: 
time date From account-name #line-number: 
message-text 


If the specified accountname is not logged on, the following message is 
displayed: 
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MSG 


Available 


See Also 


2-258 


[337] Message was not sent because 

a) user not logged on 

b) user in debugger, but not at input 

c) line is trapped. 


Note: Depending on your system, MSG can interrupt data entry on 
receiving terminals. Up to 16 characters can be lost at the 
receiving terminal due to the interference of the message. If 
this occurs, the user at the receiving terminal can enter <CTRL- 
R> to view the remaining characters of the interrupted input. 


:MSG !* The meeting is now in progressJ 

Message sent to all lines. 


14:11:00 12 MAR 1991 From SYSPROG #2: 

The meeting is now in progress 


Above message as it 
appears on user terminals. 


:MSG 9 


Please come 


to my officeJ 

Message sent to a single 
line. 


14:13:00 12 MAR 1991 From SYSPROG #2: 

Please come to my office 

Message as it appears on 
line 9. 


On Any user account. Must have privilege level 2 to use the asterisk 
parameter. 


MESSAGE 
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MULD 

Syntax 

Description 

Available On 

See Also 


MULD multiplies two decimal integers. 


MULD n m 

n Specifies the first decimal integer, 

m Specifies the second decimal integer. 


MULD multiplies two decimal integers, which can range from 
± 140737488355327. 


:MULD -1700 5J 

Multiply -1700 by 5. 

-8500 

Result. 


Any user account. 


ADDD 

DIVD 

MULX 

SUBD 
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MULX 

Syntax 

Description 


Available On 

See Also 


MULX multiplies two hexadecimal numbers. 


MULX n m 

n Specifies the first hexadecimal number, 

m Specifies the second hexadecimal number. 


MULX multiplies two hexadecimal numbers, which can be positive or 
negative. Negative numbers range from FFFFFFFFFFFF to 
800000000001. Positive numbers range from 0 to 7FFFFFFFFFFF. If 
fewer than 12 hexadecimal characters are entered, high order zeroes are 
assumed. 

Note: The result is limited to a six-byte maximum field. 


:MULX A A J 

Multiply A by A. 

64 

Result. 


Any user account. 


ADDX 

DIVX 

MULD 

SUBX 
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MVERIFY 


Syntax 


Description 


MVERIFY checks previously loaded assembly language object code 
against the assembled source item. 


MVERIFY filename {itemlist} {(options} 


filename Specifies the file to be verified. 


itemlist 


(options 

A 

E 

I 


Specifies one or more explicit item-IDs, or an asterisk (*) 
to indicate all items in the file. Can be omitted if a select- 
list is present. 

Displays all error bytes. 

Prints error messages only. 

Prints item-IDs (if more than one selected). 


P Routes output to the spooler. 


MVERIFY verifies the assembly language object code in a program item, 
or mode, against the actual code loaded in the ABS frame specified by 
the FRAME operation code statement in the mode. If the process is 
successful, the following message is displayed: 

[217] Mode 'itemin' ver1fied;Frame=nnnn Size=sss Cksum=cccc 

If the process finds mismatches, they are displayed with the following 
message: 

LOC SB AB 

[218] MODE 'itemlD' Frame=nnnn has xx mismatches 

where: 

LOC Location of an error. 

SB Value that should be in that location. 

AB Current value in that location. 

Use MLOAD to reload any items that have mismatches. 
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MVERIFY 


Available 

See Also 


2-262 


Each byte in the source file with mismatches is listed, followed by the 
value in the executable frame. 


•.MVERIFY 

CUSTOMER 

PROGl 

(AJ 




[217] 

Mode 

1 PROG1 


verified; Frame 

= 

511 Size = 1FB 

Cksum 

= A03C 







:MVERIFY 

CUSTOMER 

PROG 2 

(AJ 




LOC SB 

AB 

LOC SB 

AB 

LOC SB 

AB 

LOC 

SB 

AB 

014 0C 

18 

015 13 

17 

016 0E 

0D 

017 

3A 

3C 

[218] 

Mode 

'PROG2 

Frame = 

511 

has 

78 

mismatches 


On SYSPROG or SECURITY account. 


AS 

ASM 

MLOAD 

OPT 


Ultimate Assembly Language Reference Guide. 
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OFF 


OFF ends the current terminal session and logs off the account. 


Syntax off 


Description OPT logs you off the current account and displays the following 

accounting statistics for the session just ended: 

CConnect time= n mins.; CPU= m units, lptr pages =x > 

<Logged off at time on date > 

where: 

n Number of minutes logged onto the account, 

m Number of units charged to the account, 

x Number of pages printed to the line printer. 

The system then displays the Logon Please message. 

When OFF is entered, all open print jobs are closed. If a tape unit was 
attached during the session, it is detached. 

To end work on the current account and log to another account, use 
LOGTO, which automatically logs off the current account before logging 
onto the new account. 


: OFFJ 




< Connect time = 7 mins.; CPU=1252 units; 

lptr pages=0 

> 

< Logged off 

at 16:07:30 on 20 

NOV 1991 

> 

20 NOV 1991 

16:07:30 Logon Please: 




Available On Any user account. 

See Also coff 

LOGOFF 

LOGTO 
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ON-LINE- 

Syntax 

Description 


DIAGS 

ON-LINE-DIAGS allows non-destructive diagnostic testing of Ultimate 
hardware components while the system is on-line. 

Caution: If hardware integrity is in doubt, perform a file-save as 

soon as possible. 


ON-LINE-DIAGS 


ON-LINE-DIAGS displays a menu of diagnostic programs used to 
troubleshoot suspected hardware problems. 





A 



ULTIMATE SYSTEM ON-LINE DIAGNOSTICS 




(ON-LINE DIAGS REV 2) 


TEST 

#1. 

NON-DESTRUCTIVE DISK TEST 


TEST 

#2. 

TAPE DRIVE TEST 


TEST 

#3. 

MEMORY TEST 


TEST 

#4 . 

PRINTER TEST 


TEST 

#5. 

DISPLAY STATUS OF TERMINAL LINES 


TEST 

#6. 

TAPE GAIN ADJUSTMENT TEST 



#7. 

LIST SYSTEM ERRORS (DISK ERRORS 




& EDAC MEMORY ERRORS) 



#8 . 

PRINT "ON-LINE DIAGNOSTIC DOCUMENT" 



#9. 

LOG OFF 


ENTER TEST NUMBER TO RUN: 





_ J 


Enter the desired menu number. Each menu selection is described 
below: 

Note: All test programs can be ended by pressing <BREAK> and 
entering END at the system debugger prompt (!). Option 9 
logs you off. 


2-264 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


6985-3.2 





ON-LINE-DIAGS 


6985-3.2 


TEST # 1. NON-DESTRUCTIVE DISK TEST (DISK.DIAGS) 

The Disk Test reads and then writes back every part of the disk 
accessible to the operating system, in no specific pattern. Although this 
test does not alter data, a defective component in the disk I/O chain 
(such as a bad disk controller) could inadvertently change the data that is 
written and damage your database. 

The disk test consists of six phases. The amount of time to complete all 
six phases depends on the size and type of disk being tested. It takes 
approximately 20 seconds to read or write 1000 frames. The following 
is a brief explanation of each phase: 


Phase 1: 

Frames are read in increments of 1000, starting with 
frame 1000. 

Phase 2: 

Frames are written to disk in increments of 1000, 
starting with frame 1000. The data is not changed. 

Phase 3: 

Frames are read in increments of 100, starting with 
frame 100. 

Phase 4: 

Frames are written to disk in increments of 100, starting 
with frame 100. Data is not changed. 

Phase 5: 

Every frame is read in ascending sequential order, 
starting with frame 1. 

Phase 6: 

Every frame is written to disk in ascending sequential 
order, starting with frame 1. Data is not changed. 


When the disk test is invoked, a screen similar to the following is 
displayed: 
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On-line non-destructive disk test 


This test has six (6) phases: 


Phase 1 
Phase 2 
Phase 3 
Phase 4 
Phase 5 
Phase 6 


read frames from 1 to max in 1000 frame increments. 

write frames as above (no data is altered). 

read frames from 1 to max in 100 frame increments. 

write frames as above (no data is altered). 

read all frames from 1 to max in sequential order. 

write all frames as above (no data is altered). 


You are to look for two 'symptoms 7 : 

(1) If the system hangs on a particular frame number, that 

probably means that there is a bad spot on that frame. You 
will have to do a cold-start to bring the system back on 


(2) If you see an ampersand sign (&), that means that you have 
a disk error.Break-and-END this test. You'll get back to 
the main menu automatically. Then, select program "List 
system errors' 1 to print the disk error report. 


It takes approximately 20 seconds to test 1000 frames. 
This system has nnnnn frames. 

You may break-and-END this test at any time. 


Enter Y to start the test or <CR> if you do not wish to proceed: 


To go back to TCL, press RETURN. To start the test, enter Y. Frame 
numbers are displayed as they are tested. When the test is complete, a 
screen similar to the following is displayed: 


Phase 1 Read frames; increment=1000 
49000 <- Frame being tested 

Phase 2 Write frames; increment=1000 
49000 <- Frame being tested 

Phase 3 Read frames; increment=100 
49800 <- Frame being tested 

Phase 4 Write frames; increment=100 
49800 <- Frame being tested 

Phase 5 Read frames; increment=l 
49894 <- Frame being tested 

Phase 6 Write frames; increment=l 
49894 <- Frame being tested 


2-266 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


6985-3.2 






ON-LINE-DIAGS 


If a coldstart is necessary or an ampersand is displayed, print the error 
report by re-executing ON-LINE-DIAGS and selecting option 7 to run the 
LIST-SYSTEM-ERRORS program. Or, enter LIST-SYSTEM-ERRORS at 
TCL from the SYSPROG or SECURITY account. 


TEST # 2. TAPE DRIVE TEST (TAPE.DIAGS) 

The Tape Drive Test first writes test patterns to tape at various block 
sizes. Four patterns are written to tape for each block size: 

1. 50 blocks of test pattern X’B6DB6D...' 

2. 50 blocks of test pattern X'AAAA...' 

3. 50 blocks of test pattern X’55AA55AA...' 

4. 50 blocks of test pattern X’55555555...' 

An end-of-file (EOF) mark is written to tape, then these test patterns are 
repeated, 50 blocks per pattern, for the next block size. At the end of 
the last block, another EOF mark is written to tape. 

After all test patterns are written, the program rewinds the tape and reads 
the test patterns to check for any discrepancy. You should look for the 
following symptoms: 

• The system reports parity errors by displaying a percent sign (%) on 
the screen. The system retries the tape I/O operation when a parity 
error is encountered. 

♦ After 10 retries, the system displays: 

(A)ccept/(R)etry/(Q)uit: 

To accept the error and go ahead to the next block, enter A. To retry 
another 10 times, enter R. To quit the test, enter Q. 


TEST # 3. MEMORY TEST (MEM.DIAGS) 

The Memory Test writes to memory the test pattern X'B6DB6D...', 
repeated to fill a 512-byte memory block (frame). Sufficient contiguous 
overflow frames (two bytes per lK bytes of memory) must be available. 
When the memory test is invoked, a screen similar to the following is 
displayed: 
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N 

On-line Memory Test 

This test exercises the memory by writing a test pattern in 
memory. 

The test pattern is subsequently checked for errors. 

Due to the virtual memory management scheme employed by the 
Ultimate operating system, the memory test: (1) requires 
frequent access to disk and (2) is not able to report the exact 
real memory location in case of errors. 

You are to look for three 'symptoms': 

(1) an ampersand sign (&) is displayed, which means that you 
have either a disk error or an EDAC error detected by disk 
controller. 

(2) an error message "MEMORY ERROR" is displayed, which means 
that you have a "hard" memory error. 

(3) on Honeywell-based systems, EDAC errors are reported in 
real memory location X'lF'. EDAC errors are also logged by 
the system automatically. 

You can break-and-END this test at any time. You'll get back to 
the main menu automatically. Select program "List system errors" 
to print the report. 

This system has 5120K memory. This test runs indefinitely. You 
may break-and-END this test at any item. 

Enter Y to start the test or <CR> .if you do not wish to proceed: 

___ J 


You should look for three symptoms: 

• An ampersand (&) indicates a disk error or an EDAC error detected 
by the disk controller. In this case, press the <BREAK> key and 
enter END to end this test. If you are logged to the ON-LINE-DIAGS 
account, the Main Menu is displayed. Select List System Errors to 
print the error report. 

• The error message MEMORY ERROR indicates a hard memory error. 
In this case, run TACPAC (stand-alone diagnostics for Ultimate Bull 
6000/7000 systems) to check the memory boards. To find out the 
locations of EDAC errors on Ultimate Bull 6000/7000 systems, set 
the memory boards to PARITY mode, and then run TACPAC to find 
the errors. (If the boards are set to EDAC mode, you will not be able 
to find the locations of the errors.) 

• EDAC errors are reported in real memory location X'lF' (on Ultimate 
Bull 6000/7000 systems). EDAC errors are also logged automatically 
by the Ultimate Operating System. To obtain a report of errors 
logged by the system, press <BREAK> and enter END at any time to 
end this test, and select List System Errors from the menu. 


/r ’% 
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Due to the nature of the test, most memory errors encountered do not 
report the exact memory address causing the error. Some types of 
memory errors are logged in the SYSTEM-ERRORS file. For a listing of 
the errors logged in the SYSTEM-ERRORS file, use LIST-SYSTEM- 
ERRORS from either the ON-LINE-DIAGS menu or from TCL. 


TEST # 4. PRINTER TEST (PRINTER.DIAGS) 

The Printer Test verifies whether the parallel printer is working 
properly. When invoked, the program prompts for the number of the 
parallel printer to test. If no parallel printers are connected, the 
following message is displayed: 

This system does not have parallel printers. 

The program first checks the status of the printer controller. If the status 
is ready, the program sends 50 lines of printable ASCII characters (X'2f 
to X'7E'), repeated to fill a 132-character line, directly to the printer 
controller without going through the Ultimate System spooler. 

If the status is not ready, the following message is displayed and the 
system returns to the prompt for the parallel printer to test: 

Printer is not ready. Printer status word is X'0000 1 . 


Since the printer test bypasses the spooler, it can be helpful in 
determining whether a printer problem is due to a hardware malfunction 
or to the spooler software interface. 

If the printer controller is not ready, a status word is returned and 
displayed on the screen. The printer status word on Ultimate Bull 
6000/7000 systems is: 


bit 00 - Device Ready 

bit 08 - unused 

bit 01 - Attention 

bit 09 - unused 

bit 02 - unused 

bit 10 - unused 

bit 03 - End of Form 

bit 11 - unused 

bit 04 - unused 

bit 12 - Corrected Memory Error 

bit 05 - unused 

bit 13 - Non-existent Resource 

bit 06 - unused 

bit 14 - Bus Parity 

bit 07 - unused 

bit 15 - Non-correctable Memory Error 
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Available 

See Also 


2-270 


TEST # 5. DISPLAY STATUS OF TERMINAL LINES (STATUS) 

The Status Test reports the current status of terminal lines. For further 
information, please refer to the STATUS command. 


TEST # 6. TAPE GAIN ADJUSTMENT TEST 

The Tape Gain Adjustment Test allows a Customer Service Engineer to 
adjust the gain on an Ultimate Bull 6000/7000 system tape drive. A tape 
must be mounted, on-line, and write-enabled on the drive to be tested. 
The test program writes test pattern X7FF77FF7...' to tape, using a block 
size of 8192. The program runs until you press the <BREAK> key and 
enter END. 


MENU OPTION # 7 LIST SYSTEM ERRORS 

This option displays or prints the disk and EDAC errors stored in the 
SYSTEM-ERRORS file. For details, see LIST-SYSTEM-ERRORS. 


MENU OPTION # 8 PRINT ON-LINE DIAGNOSTICS DOCUMENT 

This option displays or prints a document containing further information 
about the on-line diagnostics. 


On SYSPROG or SECURITY account. 


LIST-SYSTEM-ERRORS 

STATUS 

System Management Guide on System Error Reporting and 
Interpretation. 
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OPT 


Syntax 


Description 


Available On 


OPT is used to assemble a program on Ultimate S/370 and S/390 
systems. 


OPT filename {itemlist} {(L} 

filename Specifies the file containing items to be assembled. 

itemlist Specifies one or more explicit item-lDs, or an asterisk (*) 
to specify all items in a file. Can be omitted if a select- 
list is present. 

(L Generates an instruction that allows a BREAK at each 

label. 


For further information on OPT, please refer to the Ultimate Assembly 
Language Reference Guide. 

Any user account on Ultimate S/370 and S/390 systems. 
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p 

p 

Syntax 

Description 


Available On 

See Also 


/T^ 

W 


The P command switches the terminal display feature on and off. 


P {(options} 

(options 

I Suppresses terminal display, regardless of the current 

status of the command. 

L Allows terminal display, regardless of the current status 

of the command. 


When used without any options, the P command toggles terminal 
display on or off. 

Terminal display on (the normal condition) displays information from 
the system on your terminal. 

Terminal display off suppresses all display on the terminal except for the 
echoing of keyboard input. System messages and menus, for example, 
will not be displayed until after another P command is entered. 

Display of keyboard input can be controlled with the ECHO-OFF and 
ECHO-ON commands. 


Any user account. 


ECHO-OFF 

ECHO-ON 
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PAGEIO-OFF 


On some LSI systems, the PAGEIO-OFF command returns a line 
previously set to PAGEIO mode to normal input mode. 


Syntax pageio-off 

Description On smaller LSI systems (series 2000, and series 3000 models below 

model 3030), the normal input mode is PAGEIO-OFF. On these systems, 
PAGEIO-OFF is used when a line currently operating in PAGEIO-ON mode 
needs to be reset to normal input mode. 

PAGEIO-ON mode is designed to accommodate bursts of input data on a 
line that your system cannot handle fast enough in normal input mode. 
This situation can happen if a line is used to take input from a device 
other than a terminal. The PAGEIO-OFF command resets the line to 
normal input mode, which is the setting for all lines after a coldstart on 
smaller LSI systems. 

On larger LSI systems, (series 3030 and above), the normal input mode 
is PAGEIO-ON. Therefore, PAGEIO-OFF should not be needed. 


Available On Any user account on the systems indicated above. 
See Also pageio-on 
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PAGEIO-ON 

Syntax 

Description 


Available On 

See Also 

2-274 




PAGEIO-ON initiates PAGEIO mode on the line that issues the command. 


PAGEIO-ON 


On smaller LSI systems (series 20(X) and series 3000 models below 
model 3030), the normal input mode is PAGEIO-OFF. However, 
PAGEIO-ON mode can be used for terminal input when bursts of input 
data on a line cannot be handled fast enough by the computer in normal 
input mode. This can happen if a line is used to take input from a device 
other than a terminal. 

On larger LSI systems (series 3030 and above), the normal input mode 
is PAGEIO-ON. On these systems the PAGEIO-ON command is not needed 
unless the typeahead feature has been turned off (TYPEAHEAD-OFF), 
which automatically turns PAGEIO off. In this case, PAGEIO-ON can be 
reset by issuing this command or a TYPEAHEAD-ON command. 

The visible effect of the PAGEIO-ON command varies with different 
Ultimate systems. Sometimes the echoing of keyboard input is affected. 
Also, software such as UltiWord may not work properly on some 
systems when input is requested one character at a time, without a 
carriage return. On Ultimate Bull 60(X)/70(X) systems and larger LSI 
systems, the effect of the PAGEIO-ON command is to return the system to 
normal input mode. On smaller LSI systems where PAGEIO-OFF is the 
normal input mode, this command enables the PAGEIO-ON mode. The 
PAGEIO mode remains in effect until it is reset via PAGEIO-OFF or a 
system coldstart. 


Any user account on Ultimate Bull 6(X)0/7(XX) systems, and the LSI 
systems indicated above. 


PAGEIO-OFF 

TYPEAHEAD-OFF 

TYPEAHEAD-ON 
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PART-UPDATE-SAVE 

PART-UPDATE-SAVE saves to a file-save tape all groups that have been 
updated since the last full FILE-SAVE, PART-UPDATE-SAVE, or ALL¬ 
UPDATE-SAVE. It also resets the group-updated flags. 


Syntax part-update-save 

Description PART-UPDATE-SAVE saves all updates to your system since the last FILE- 

SAVE, PART-UPDATE-SAVE or SAVE. Updates consist of creating, 
changing, or deleting an item, file, or account. PART-UPDATE-SAVE also 
resets the group-updated flag associated with each group. 

The advantage of PART-UPDATE-SAVE over ALL-UPDATE-SAVE is that it 
saves time and tape on each update save. However, the disadvantage is 
that in order to restore your system, the full file-save tape, as well as 
every subsequent PART-UPDATE-SAVE tape, is required. 

When PART-UPDATE-SAVE is invoked, the file data area is saved, the 
filenames are printed, any Group Format Errors (GFEs) are repaired, the 
saved groups are output to magnetic tape, and the updated flags of the 
saved groups are reset. 

If PART-UPDATE-SAVE is aborted, the next save must be a full file-save. 
A partial save cannot be performed because it would be impossible for 
the system to determine which group-updated flags had been reset or not 
reset before the part-update-save operations aborted. If you attempt to 
do a PART-UPDATE-SAVE after an abort, the following message is 
displayed: 

[994] Full file save required 


Available On sysprog or security account. 


See Also all-update-save 

FILE-SAVE 

SAVE 

System Management Guide for information on file-saves. 
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PASSTHRU 


Syntax 


Description 


PASSTHRU causes terminal input/output (I/O) to be redirected to another 
line, allowing you to use a line on your system to access another 
system. 


PASSTHRU n{,baud} {(esc-code)} 

n Specifies the line number from which terminal input is to 

be received and to which terminal output is to be 
transmitted. 


,baud Specifies the baud rate of the target terminal using 

PASSTHRU. 

(esc-code) Specifies the ASCII code value of a keyboard character 
used as part of an escape sequence to terminate the 
PASSTHRU operation. If no escape code is specified, a 
value of decimal 88 is used, corresponding to the 
character X (that is, the default escape sequence is <ESC- 
X>). 


PASSTHRU causes all subsequent characters typed at your terminal to be 
sent out on the specified line, and causes all characters input on the 
specified line to be displayed on your terminal. 

This mode of passthrough interaction remains in effect until the 
specified escape code sequence is entered at your terminal. This breaks 
the connection to the specified line and normal terminal I/O is resumed. 
The escape code sequence is the ESC character (hexadecimal X’lB'), 
followed by the escape code character specified in the command (or by 
the default X, decimal 88). 

PASSTHRU is useful when the specified line is connected to another 
computer, such as via a modem. In effect, you can interact with the 
remote computer as if there were no local computer. 

The specified line must not have anyone logged on to it. 
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Available 


6985-3.2 


You can execute PASSTHRU from BASIC via the EXECUTE statement. 
The returned and displayed data can be saved by using the CAPTURING, 
redirection variable as follows: 

EXECUTE "PASSTHRU 3,9600" CAPTURING.> OUTPUT 

Ultimate has integrated this operation into a BASIC subroutine called 
CAPTURE in the SYSLIB file, which uses PASSTHRU to capture all data 
echoed at your terminal, and stores it in an Ultimate file. Please refer to 
appendix E for further information on the CAPTURE subroutine. 


:PASSTHRU 6 (67)J 

Executes passthru on line 6; 


specifies the letter C as the escape 


character. 

:PASSTHRU 15,1200J 

Executes passthru on line 15 at 


1200 baud. 


On Any user account. 
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PIE is an UltiPlot command that generates a pie chart from a list of 
items. PIE is a graphic equivalent of the LIST command. 

Note: Since data should he in sorted order to create a meaningful 

chart or graph, you may prefer to use the SPIE command. Or, 
you can sort data with SSELECT, and the resulting select-list 
can be saved with SAVE-LIST. The actual charting could then 
be done later by retrieving the sorted list via GET-LIST, 
followed by the PIE command. 


PIE filename {Itemllst} {sel-criteria} {output-specifications} 

{(options} 

filename Specifies the file for which information should be 

charted. 

itemlist Specifies one or more explicit item-lDs. If specified, 

each item-lD must be enclosed in single quotes. If 
omitted, the command acts on the current select-list, 
or on all items in the file if no select-list is present. 

sel-criteria Conditions that must be met by an item in order for 

it to be charted. Also known as a WITH clause. 


output- Specifies the attributes and values in the selected 

specifications items that should be charted. 


(options 

C Suppresses column heading lines that define 

attributes in a report. 

D Suppresses all detail lines from a report. 

H Suppresses the report's page heading line and "n 

items listed" line. 

I Suppresses the item-lD column or row heading. 
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Description 


Available On 


6985-3.2 


PIE 


P Routes output to the spooler. 

N Specifies no automatic end-of-page waiting. 


For further information on PIE, please refer to the UltiPlot Reference 
Guide. 


Any user account. 
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PLOT 


PLOT is an UltiPlot command that generates a rectangular chart, bar 
graph, line graph, or scatter diagram on a Printronix dot-matrix printer. 
PLOT is a graphic equivalent of the LIST command. 

Note: Since data should be in sorted order to create a meaningful 
chart or graph, you may prefer to use the SPLOT command. 
Or, you can sort data with SSELECT, and the resulting select- 
list can be saved with SAVE-LIST. The actual charting could 
then be done later by retrieving the sorted list via GET-UST, 
followed by the PLOT command. 


Syntax 


PLOT filename {itemlist} {sel-criteria} (output- 
specifications) {(options) 

filename Specifies the file for which information should be 

charted. 


itemlist One or more explicit item-IDs. If specified, each 

item-ID must be enclosed in single quotes. If 
omitted, the command acts on the current select- 
list, or on all items in the file if no select-list is 
present. 


sel-criteria Conditions that must be met by an item in order for 

it to be charted. Also known as a WITH clause. 


output- Specifies the attributes and values in the 

specifications selected items that should be charted. 


(options 

C 

D 

H 

I 


Suppresses column heading lines that define 
attributes in a report. 

Suppresses all detail lines from a report. 

Suppresses the report's page heading line and "n 
items listed" line. 

Suppresses the item-ID column or row heading. 
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Description 


Available On 


6985-3.2 


P Routes output to the spooler. 

N No automatic end-of-page waiting. 


For further information on PLOT, please refer to the UltiPlot Reference 
Guide. 


Any user account. 
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POVF 


Syntax 


Description 


2-282 


r % ) 


POVF displays the table of available virtual frame space, which indicates 
the system available disk space, broken down into the total number of 
frames of contiguous space and linked space. 


POVF {(P) 

(P Routes output to the spooler. 


POVF displays the available system disk space in the system overflow 
table in the following format: 

nnn (mmm) ppp (qqq) 

xxxxx-yyyyy : ccccc vvvvv-wwwww : ddddd 

Total number of contiguous frames : nnnnnn 

where: 


nnn (mmm) 

FID (frame ID) of the first frame in linked 
available space; contains mmm frames. 

ppp (qqq) 

FID of the beginning of the extended TCL 
workspace set; contains qqq frames. 

xxxxx or vvvvv 

First frame of the block. 

yyyyy ° r wwwww 

Last frame of the block. 

ccccc or ddddd 

Total number of frames in the block. 

nnnnnn 

Total of all the contiguous available space 
frames on the system. 


Since only non-empty portions of the table are printed, if there is no 
linked available space chain, nnn and (mmm) are not printed. 

Workspaces for all extended TCL levels are obtained from available 
space. 

After a file-restore, all available space is contiguous until normal system 
operation obtains and releases portions of that space. A linked chain of 
available space is created only when there are 31 sets of contiguous 
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POVF 


Available 

See Also 


available space, which is the maximum number the system space 
management routines can maintain. 


:POVFJ 





3936 

( 823) 


5549- 

5551 : 3 6746- 

6746 : 

1 

6748- 

7160 : 431 7254- 

7258 : 

2 

23054- 

23289 : 236 26000- 

148159 : 

122159 

Total number of contiguous frames 

: 122832 



On Any user account. 


System Management Guide for information on system file structure 
and allocation, and the extended level overflow table. 
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PRIME 

Syntax 

Description 


Available On 

2-284 


PRIME prints the smallest prime number equal to or greater than a 
specified number. 


PRIME {n} 

n Specifies the number to be tested as prime. If omitted, 

the system prompts for a number. 


Use PRIME to test whether a number is prime, or to find the next prime 
number greater than the number entered. 

PRIME can help decide what value to select for the modulo of a new file, 
since modulos that are prime numbers are more likely to cause items in 
the file to be distributed evenly. 

If a number is omitted, PRIME prompts for the number to test: 

Enter # to test: 

If the number entered is prime, the system displays the following 
message: 

n is prime! 


If the number entered is not prime, the system begins checking each odd 
number greater than the number entered. The numbers and their 
divisors are printed until a prime number is found. 


:PRIMEJ 




Enter 

# to test:32J 



32 is 

even! 




33 is 

evenly 

divisible 

by 

3 

35 is 

evenly 

divisible 

by 

5 

37 is 

prime! 





Any user account. 
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PRINT-ERR 


PRINT-ERR displays messages stored in ERRMSG, or other specified file 
using ERRMSG format. 


Syntax 


PRINT-ERR filename {itenilist} {(P) 


filename Specifies the file (normally ERRMSG) to be accessed for 
item display. 

itemlist Specifies one or more explicit error message numbers, or 
an asterisk (*) to indicate all error messages in the file. 
Can be omitted if a select-list is present. 


(P 


Routes output to the spooler. 


Description PRINT-ERR verifies system error message or other message file contents, 

and displays specified items. Messages containing parameters, such as 
the TERM command, have dummy parameters A, B, C, D, and so on, 
inserted in the message display. 


:PRINT-ERR 

ERRMSG 2 01J 

[201] 'A' is 

not a file 

name 

:PRINT-ERR 

ERRMSG 2 8 9J 


Terminal 

Printer 

Page width: 

A 

B 

Page depth: 

C 

D 

Line skip : 

E 


LF delay : 

F 


FF delay : 

G 


Backspace: 

H 


Term type: 

I 



Available On Any user account. 

See Also System Management Guide for information on the ERRMSG file. 
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PRINTER 


PRINTER 


Syntax 


Description 




PRINTER displays or sets printer characteristics. 


PRINTER {line-length} {page-length} {printer-code} 


line-length Specifies the maximum number of characters per 
line, normally 80 or 132. 

page-length Specifies the maximum number of lines per page, 
normally 66. 


printer-code Specifies the type of printer. The standard Ultimate 
system includes definitions for the following printer 
types: 

H Honeywell (NEC) letter quality printer 
L Hewlett-Packard LaserJet printer 


Note: If parameters are omitted, the current settings are displayed. 


PRINTER affects printer output only on the line issuing the command. 

If only the printer-code is to be changed, all other parameters can be 
omitted from the command. Printer codes are stored as items in the 
TERMDEF file on the SYSPROG account. 

The line-length and page-length parameters can also be displayed and 
modified with the TERM command. However, printer-code can only be 
displayed and modified with the PRINTER command. 

The printer-code value is not important for most printer output. Only 
software such as UltiWord adjusts output according to printer type, 
since it contains program code specifically for letter quality printers. A 
menu is provided by UltiWord for setting up items such as the printer 
code. 


T'y. 

\,-.y 
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PRINTER 



Available 

See Also 


:PRINTERJ 

Page width 

132 

Page depth 

60 

Type 

H 

:PRINTER 

,59,LJ 

:PRINTERJ 

Page width 

132 

Page depth 

59 

Type 

L 


On Any user account. 


SET-LPTR 

TERM 
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PRINTER. DIAGS 


PRINTER. DIAGS 

PRINTER.DIAGS is used by the ON-LINE-DIAGS command to test parallel 
printer operation. Ultimate recommends that you use the ON-LINE- 
DIAGS command to run diagnostic tests. 

For further information on PRINTER.DIAGS, please refer to ON-LINE- 
DIAGS. 
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PRINTRONIX 

PRINTRONIX sets the number of lines per page on Printronix printers. 

Syntax printronix 

Description When PRINTRONIX is invoked, it prompts for the maximum number of 

lines to print on a form before automatic eject. The standard number of 
lines for 11-inch long paper is 66. 

:PRINTRONIXJ 

Number of lines?: 66 

Available On sysprog or security account. 

See Also PRINTER 

TERM 
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QSELECT 

Syntax 


Description 


Available On 
See Also 

2-290 


QSELECT creates a select-list from attributes in an item, or from items in 
a file. 


QSELECT filename {itemlist} {(n)} 


filename Specifies the file whose items are to be used to create the 
select-list. 

itemlist Specifies one or more explicit item-lDs, or an asterisk (*) 
to indicate all items in the file. Can be omitted if a select- 
list is present. 

(n) Specifies the attribute number whose item data is to be 

included in the select-list. If omitted, all attributes are 
selected. 


QSELECT selects all itemlist items, using either all attribute data or data 
from a single attribute, and creates a select-list. The select-list can be 
saved with SAVE-LIST for use in subsequent system commands or BASIC 
programs. Multiple values are stored as separate elements in the select-list. 

Note: QSELECT and CORY-LIST are inverse functions. QSELECT 

creates a select-list from attributes in items, while COPY-LIST 
creates an item from a select-list. 


:QSELECT INVENTORY 0123 2990 (2)J 

Selects attribute 

2 items selected. 

2 from the 


specified items. 


Any user account. 


COPY-LIST 

SAVE-LIST 

SELECT 

SSELECT 

Ultimate BASIC Language Reference Guide. 

Ultimate RECALL and Ultimate UPDATE User Guide. 
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RAISE-DTR 


RAISE-DTR raises the Data Terminal Ready (DTR) status on a specified 
line. 


Syntax raise-dtr {n} 

n Specifies the line on which to raise DTR. If omitted, the 

current line is assumed. 


Description RAISE-DTR allows a line to be connected for communications. On a 

dial-up line, DTR must always be high to maintain the connection 
between the system and the remote line. 

On Ultimate 1400 systems, RAISE-DTR raises both DTR and Request To 
Send (RTS). If the line number is omitted, RAISE-DTR raises DTR and 
RTS on the current line. 


: RAISE-DTR 2J 


Available On SYSPROG or SECURITY account on Ultimate Bull 6000/7000 systems 

and Ultimate 1400 systems. 


See Also 


DROP-DTR 

DROP-RTS 

RAISE-RTS 
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RAISE-RTS 

RAISE-RTS raises the Request to Send (RTS) status on a specified line. 

Syntax raise-rts {n} 

n Specifies the line on which to raise RTS. If omitted, the 

current line is assumed. 


Description raise-rts is the inverse of DROP-RTS. The effect of raising RTS 
depends on what device is connected to the line, and how the line is 
wired. 

If a modem is attached, raising RTS causes the modem to raise Clear To 
Send (CTS), which in turn causes the system to output data on the line. 

On Ultimate 1400 systems, RAISE-RTS raises both Data Terminal Ready 
(DTR) and RTS. If the line is not specified, RAISE-RTS raises DTR and 
RTS on the current line. 


: RAISE-RTS 2J 


Available On SYSPROG or SECURITY account on Ultimate Bull 6000/7000 systems 

and Ultimate 1400 systems. 


See Also 


DROP-DTR 

DROP-RTS 

RAISE-DTR 
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READ-STATUS 


READ-STATUS returns the hexadecimal communications status for a 
specified line. 


Syntax read-status {n} 

n Specifies the line whose status is to be read and 

displayed. If omitted, the current line is assumed. 


Description Use READ-STATUS to verify communication flags current status. The 

status codes are determined by the settings of bits that indicate the 
current state of the RS232 control signals. For example: 

EO Data Set Ready (DSR), Clear To Send (CTS), and Carrier 

Detect (CD) are high. 

CO DSR and CTS are high. 

80 DSR is high. 


The following chart shows the meaning of each bit and its hexadecimal 
value. Use this chart to interpret the status codes. 



DSR 


CTS 


C D ring 

indica¬ 

tor 


read is DTR 
enabled 


: READ-STATUSJ 

Read the status of the current line. 

El 

DSR, CTS, CD, DTR all high (80+40+20=E, 

: 

DTR=1) 


Available On SYSPROG or SECURITY account on Ultimate Bull 6000/7000 systems. 
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REALLOCATE 

REALLOCATE calculates a new modulo for files, which can then be used 
to update all files on the system, a single account, or a single file. 


Syntax reallocate 

Description REALLOCATE uses STAT-FILE information produced by the last FILE- 

SAVE to calculate a new modulo for all files or a specified account or 
file. It always uses a separation of 1. REALLOCATE places the new 
modulo in SYSPROG's REALLOC-FILE and optionally updates attribute 13 
of each file's D-pointer with the new modulo. The actual reallocation of 
files using the new modulos is performed when the next file-save and 
file-restore is done. 

With the aim of minimizing the need for overflow space, REALLOCATE 
performs the following calculation: 

• Calculate the number of items with growth allowance, where 
(GROWTH = 1.05): NO. ITEMS = INT((ITEMS * GROWTH) + .5) 

• Calculate the new file size: 

a. If AVERAGE ITEM SIZE >= ID.DATA.SIZE then 
NEW .MODULO = NO.ITEMS 

b. If AVERAGE ITEM SIZE < ID.DATA.SIZE then 

NEW.MODULO=INT(NO.ITEM S/I NT (I D.D ATASIZE/A VG.ITEM.SIZE)+ .5) 

• Set the new modulo equal to the nearest prime number that is greater 
than or equal to the new modulo just calculated. 

When invoked, REALLOCATE displays the following menu: 
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— 

The ULTIMATE File Reallocation Menu 
12:08:122 17 NOV 1991 

1. Reallocate All Files Automatically 

2. Calculate Suggested Reallocation Parameter For 
All Files 

3. List Reallocation Parameters to Printer 

4. Reallocation Entry Maintenance 

5. Update Files With New Reallocation Parameters 

6. Clear Reallocation Parameters from File Pointers 
88. Logoff 

99. Go to TCL 

Enter Selection - 

V_ ) 


At the Enter Selection prompt, enter the desired option number. Each 
option is explained below: 

1. Reallocate All Files Automatically 

Option 1 is a combination of options 2 and 5. When option 1 is 
selected, the following prompt is displayed: 

Is it OK to down size a file (YES/<CR>=N)? 

If the modulo cannot be reduced, press RETURN. If the modulo can be 
reduced, enter YES. The following prompt is displayed: 

xxx data bytes per frame (YES=<CR>/N)? 

The value of xxx is the frame size of the machine being used. If the 
files are to be restored on a system with a different frame size and 
running a pre-200 revision of the operating system, or if the displayed 
frame size is not correct, enter N; otherwise, press RETURN. If N is 
entered, a prompt similar to the following is displayed: 

Enter new frame size (mod 500), or press <CR> to use 
xxx: 


Ultimate System Commands Guide 2-295 

Confidential and Proprietary to The Ultimate Corp. 





REALLOCATE 


Enter the new frame size. New values for modulo and separation are 
calculated for all files listed in STAT-FILE, and placed in REALLOC-FILE. 
The following messages are displayed: 

Now clearing Reallocation file 
Now selecting Stat-File 
Now processing - 
Processing complete. 

REALLOCATE calculates new modulos for all files, but will not update 
any D-pointers if there is not enough disk space to do so. 

2. Calculate Suggested Reallocation Parameter For 
All Files 

When option 2 is selected, the following prompt is displayed: 

Is it OK to down size a file (YES/<CR>=N)? 

If the modulo cannot be reduced, press RETURN. If the modulo can be 
reduced, enter YES. The following prompt is displayed: 

xxx data bytes per frame (YES=<CR>/N)? 

The value of xxx is the frame size of the machine being used. If the 
files are to be restored on a system with a different frame size and 
running a pre-200 revision of the operating system, or if the displayed 
frame size is not correct, enter N; otherwise, press RETURN. If N is 
entered, a prompt similar to the following is displayed: 

Enter new frame size (mod 500), or press <CR> to use 
xxx: 


Enter the new frame size. New values for modulo and separation are 
calculated and placed in REALLOC-FILE. The following messages are 
displayed: 

Now clearing Reallocation file 
Now selecting Stat-File 
Now processing - 
Processing complete. 
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3. List Reallocation Parameters to Printer 

When option 3 is selected, the following information is printed for each file: 

• Reel Number 

• Sequence Number 

• File Level (l=account, 2=dictionary, and 3=data section) 

• Account Name 

• Dictionary Name 

• File Name 

• Current Modulo 

• Current Separation 

• New Modulo 

• New separation 

• % of growth 

4. Reallocation Entry Maintenance 

After REALLOCATE calculates a suggested new modulo (that is, after 
executing option 1 or 2), you can override it with your own calculation. 

To do this, you must know the reel number and sequence number of the 
file to be changed as it exists on the File Statistics Report. (Use LIST- 
FILE-STATS, if needed.) 

When option 4 is selected, the following screen is displayed: 
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-N 

File Reallocation Maintenance 

Reel Number File Seq. Number 

Account Name - 
File Name - 
Level - 

Modulo Separation Prime 

Current Size 
Reallocation 

Suggested Reallocation 
New Reallocation 
— <D> to delete 

n_/ 


To exit this screen and return to the Reallocation menu, enter END at the 
Reel Number prompt. Otherwise, enter the reel number and file 
sequence number. Data will be displayed for the Account Name, File 
Name, File Level, Current Modulo, Current Separation, Current Prime, 
and Current Reallocation (if a reallocation parameter was previously 
calculated). 

Enter a new modulo. To make changes to the new reallocation, enter D 
to delete the entry. Enter END to return to the Reel Number prompt. 

The file or files are not updated. To update files with a new calculation, 
select option 5 below. 

5. Update Files With New Reallocation Parameters 

Option 5 uses the reallocation parameters from the REALLOC-FTLE. All 
files that have been designated in the REALLOC-FILE for reallocation are 
updated with the new modulo as a reallocation parameter. 

To perform the actual file reallocation, a file-save and file-restore must 
be done. . 
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REALLOCATE 


Available 

See Also 


6985 - 3.2 


If reallocation is specified but there is not enough disk space to increase 
file size, D-pointers are not updated. If reallocation will reduce file 
sizes, the following prompt is displayed: 

THIS PROCEDURE WILL UPDATE ALL FILES WITH NEW 
REALLOCATION 

DO YOU WANT TO CONTINUE (Y/N)? 

If N is entered, the Enter Selection prompt of the Reallocation Menu is 
redisplayed. 

If Y is entered, the following messages are displayed: 

Now selecting Realloc-File 
Now processing - 
Processing complete. 

6. Clear Reallocation Parameters from File Pointers 

This option clears any reallocadon parameters that may have been added 
to attribute 13 of file definition items. 

On SYSPROG or SECURITY account. 

System Management Guide for information on file reallocation. 
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RECEIVE 


Syntax 


RECEIVE allows you to receive bisync messages into a specified file, 
into the RECEIVED-MSGS file, or into the spooler. 


RECEIVE {filename} {item-lD} {(options} 

filename Specifies name of the file to receive messages. If 
omitted, the file RECEIVED-MSGS is assumed. 

item-ID An item-ID is required for the G option below. 

(options 

A Indicates messages are in 3780 format. 

B Specifies block mode. Each block of data is filed as an 

item, using a sequential item-ID starting with 1. Each 
execution of RECEIVE resets the item-ID back to 1. If the 
item-ID already exists in the file, it is replaced by the 
newly received item. 

C Files printer control characters with the received data. If 

omitted, embedded printer control characters are stripped 
before the data is written to the file. 

D Displays the incoming message to the screen as it is 

received. This option has no effect on the filing or 
printing of the message. 

E Ends the receive process and returns to TCL after 

receiving one message. If omitted, the process remains 
in receive mode indefinitely. 

F Files the message in the receiving file. This overrides 

any printer selection sequence in the message. 

G Indicates an item-ID in which to receive data is specified 

following the filename. 

P Routes output to the spooler. 

U Specifies Ultimate mode. The first record of the received 

message becomes the message’s item-ID in the receiving 
file. Care should be taken that the transmitting station 
intends the first record to become the item-ID. 
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RECEIVE 


Description 


If the first record already exists as an item-lD in the 
RECEIVED-MSGS file, then a default date-time-# item-lD 
is constructed and the first record becomes the first 
attribute of the new item. Problems can occur if the first 
record received is larger than the maximum item-ID size 
of 50 bytes. 

W Returns to TCL if the state WAITING FOR 

COMMUNICATIONS LINE TO BE CONNECTED is 
encountered. Prints the waiting message before exiting 
to TCL. 

X Contains the terminal identification string received from 

the remote computer when bidding for the 
communications line. When the local computer is 
bidding to transmit to the remote computer, this string is 
received from the remote computer with the 
acknowledgement. 


When an Ultimate system is performing data communications using a 
binary synchronous communications protocol with a 2780- or 3780- 
type communications device, RECEIVE is used to set a terminal to 
receive status. A bisync channel must already be attached with B-ATT. 

Note: When using the RECEIVE command to receive bisync 

messages, be sure the RECEIVE command uses the same 
protocol as used in the transmission. That is, both must use 
2780 mode or both must use 3780 mode. The 2780 mode is 
the default. 

The options allow the operator alternative display/storage methods and 
to end receive status after a single message. 

If no options are present, the destination (file or printer) of the received 
message is determined by a component selection sequence at the start of 
the first received record. (For details on this sequence, see IBM's “2780 
Component Description” document.) If the component selection 
sequence is omitted, the message is filed in the RECEIVED-MSGS or 
other specified file. 
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Available On 

See Also 


A filed message is assigned an item-ID. The default is a date-time-# 
item-lD. The format is DD MON YY-HH:MM:SS-#, constructed by 
combining the date and time (24-hour clock) that the message was 
received with the message's sequence number. 

If the transmission is in transparent mode (TRANSMIT with the H 
option), the following message is displayed when the first record is 
actually received: 

[317] Transparent text being received 

During transparent mode, if a segment mark is part of the received 
message, the following message is displayed: 

[318] A "SM" (X'FF 1 ) was converted to a "NULL" (X'OO') 
in received transparent text. 


After the message has been printed/stored, receive mode is re-entered to 
receive another message (unless the command has the E option). 

You can halt the receive process, disconnect the line, and return to TCL 
at any time by pressing <BREAK> and entering END. 


SYSPROG or SECURITY account. 


B-ATT 

General Information-Binary Synchronous Communication , 
IBM Document Number GA27-3004. 

Component Description: IBM 2780 Data Transmission Terminal, 
IBM Document Number GA27-3005. 
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RECOVER 

Syntax 

Description 


FD 

RECOVER-FD allows you to recover an item deleted with the FD 
command in the Line Editor, if possible. 


RECOVER-FD 


You must use RECOVER-FD immediately after you delete the item you 
want to recover. 

Caution: Do not specify the item-lD in the command line, as this 

guarantees that the item will not be recovered. 

When RECOVER-FD is invoked, the following prompt is displayed: 
Enter item-id * 


Enter the exact item-lD you just deleted, and press RETURN. 

Caution: If you press RETURN alone at the Enter item-id * 

prompt, you may never be able to recover the item. 

If you enter an incorrect item-ID, the Enter item-id * prompt is 
redisplayed. 

Once you enter the correct item-ID, the deleted item is recovered and the 
following message is displayed: 

' itermCD 1 filed. 

Once recovered, the item is placed back into the same file from which it 
was deleted. Also, the item is restored back to the state it was in prior to 
the last FS or FI Line Editor command. 

If there are no recoverable items, the following message is displayed: 
[401] No items present. 

Note: You cannot use RECOVER-FD if you deleted the item with FD 

while using EDIT-LIST. 
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Available 

See Also 


2-304 


:ED SALES CLIENTJ 

Top 

001 MY BEST CLIENT 
002 COMPANY NAME 
003 ADDRESS 
004 TELEPHONE NUMBER 
EOI 004 
. FD 

'CLIENT' deleted. 

:RECOVER-FDJ 

Enter item-id * CLIENTJ 

'CLIENT' filed. 



On Any user account. 


Guide to the Ultimate Editors. 
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REFORMAT 


Syntax 


Description 


Available On 


6985-3.2 


REFORMAT is an Ultimate RECALL command that creates a new file 
from items in a specified file, according to indicated selection criteria, 
modifiers, and options. 


REFORMAT filename {itemlist} {sel-criteria} {output- 
specifications {print-limiters}} {(options} 

filename Specifies the file containing the items to be 

reformatted. 


itemlist Specifies one or more explicit item-lDs. If 

specified, each item-lD must be enclosed in single 
quotes, double quotes, or backslashes. If omitted, 
the command acts on the current select-list, or on 
all items in the file if no select-list is present. 


sel-criteria Conditions that must be met by an item in order for 

it to be processed. Also known as a WITH clause. 

output- Specifies the attributes and values in the 

specifications selected items that should be processed. 


print-limiters 

(options 

C 

H 

I 


Restricts the printing of output specification to 
values that meet the limit conditions. 

Suppresses column heading lines that define 
attributes in a report. 

Suppresses the report's page heading line and "n 
items listed" line. 

Suppresses the item-ID column or row heading. 


For further information on REFORMAT, please refer to the Ultimate 
RECALL and Ultimate UPDATE User Guide. 


Any user account. 


Ultimate System Commands Guide 2-305 

Confidential and Proprietary to The Ultimate Corp. 



RENAME-ACCOUNT 


RENAME-ACCOUNT 

RENAME-ACCOUNT changes the name of an existing account. 


Syntax 


rename-account {accountnamel} {accountname2} {(Q) 

accountnamel Specifies the current name of an account to be 
changed. If omitted, the system prompts for it. 

accountname2 Specifies the new name of the account. This 
name must not already exist as an account. If 
omitted, the system prompts for it. 


(Q Updates all Q-pointers in all Master Dictionaries 

to specify the new accountname. Updates all D- 
pointers in all Master Dictionaries and all file 
dictionaries to give the new accountname access. 


Description Use rename-account to rename an account. When an account is 
renamed, the logon PROC or BASIC program in the account’s Master 
Dictionary is also renamed. All Q-pointers in SYSTEM that point to the 
old account are updated to the new accountname. All update and 
retrieval locks for all D-pointers and Q-pointers in SYSTEM are also 
updated to the new accountname. 


:RENAME-ACCOUNTJ 

Enter Account Name ?OLDNAMEJ 
Enter New Name 7NEWNAMEJ 
[250] 'NEWNAME' updated. 


Available On SECURITY account, or SYSPROG if security is enabled. 
See Also create-account 
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RENAME 


Syntax 


Description 


6985 - 3.2 


FILE 

RENAME-FILE changes the name of a file. 

RENAME-FILE {filenamel} {filename2} 

filenamel Specifies the current name of a file. If not specified, the 
system prompts for it. 

filename2 Specifies the new name of the file. If not specified, the 
system prompts for it. 


Use RENAME-FILE to change a filename. To use RENAME-FILE, you 
must have update access to your Master Dictionary, and you must have 
update access to the file dictionary to update the D-pointer. 

RENAME-FILE operates only on the D-pointers in the current Master 
Dictionary. RENAME-FILE cannot change the file synonym definition 
items (Q-pointers), and cannot change D-pointers referred to via Q- 
pointers (such as files on a different account). 

Depending on the form of the filename specified, the action taken by 
RENAME-FILE will differ as follows: 

dataname Renames the dictionary section and its 

data section having the same name. No 
other data section names are changed. 

dictname,dataname Renames only the specified data section 

when the dictname has multiple data 
sections. 

DICT dictname Renames the dictionary section only. 

DATA dataname Renames only the data section having 

the same name as its dictionary. 
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data dictname,dataname Renames only the specified data section 

when the dictname has multiple data 
sections. Same as 
dictname,dataname above. 

If neither filename is specified, the following prompts are displayed: 

Enter File Name? 

Enter New Name ? 

You cannot rename a file to a name that includes blanks, commas, or 
exceeds 50 characters. 


: RENAME-FILE 

FILEI FILE2J 

Rename FILE1 to FILE2. 

[250] ' FILE2 ' 

updated. 



Available On Any user account with privilege level 1 or greater. 
See Also create-account 
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RESET-LOGOFF 

RESET-LOGOFF disables the automatic logoff function set by SET- 
LOGOFF when Data Set Ready (DSR) drops on the specified line. 


Syntax reset-logoff {n} 

n Specifies the line for which automatic logoff should be 

disabled. If omitted, the current line is assumed. 


Description Use RESET-LOGOFF for a specified line to disable the automatic logoff 
function set up by SET-LOGOFF when DSR drops. 

On Ultimate 1400 systems only, RESET-LOGOFF also disables the logoff 
when Data Terminal Ready (DTR) and Request To Send (RTS) occur. 


: RESET-LOGOFF 3J 


Available On SYSPROG or SECURITY account on Ultimate Bull 6000/7000 systems 

and Ultimate 1400 systems. 


See Also SET-LOGOFF 
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RESTORE-ALL-ULTIS 

RESTORE-ALL-ULTIS restores one or more of the following Ultimate 
application accounts from the SYS-GEN tape: 

UltiWord 

UltiLink 

UltiMation 

ATP (Acceptance Test Procedures) 

UltiWriter 

For further information on RESTORE-ALL-ULTIS, please refer to the 
upgrade procedure for your specific platfonn. 
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RESTORE-FILE 

RESTORE-FILE restores a file from a file-save tape, account-save tape, 
update-save tape, or transaction logging tape. 


Syntax RESTORE-FILE filename {(options} 

filename Specifies the name of file to be restored; this name must 
not currently exist in the account. 

(options 

A Specifies the tape is already positioned at the desired 

account. When specified, the Account name on tape: 
prompt is not displayed. 

E Restores every version of an item or items that can be 

found on tape. System-generated item-lDs will be used 
for duplicate copies of items; the original item-ID will be 
stored as attribute one of the item (attribute six for CC- 
pointer or CL-pointer items). Must be used with the U 
option. 

M Modulo; adds modulo adjustment information. This 

must be used for files restored from systems with a 
different frame size running under revisions prior to 
200E. Cannot be used with the U option. 

S Skips initial forward spacing of the tape. Used when the 

restore starts at the beginning of the second or later reels 
of a file-save tape. 

U After file is restored from current tape, or if end of tape is 

reached, displays prompt for update and transaction tapes. 


Description RESTORE-FILE restores the dictionary level file and all associated data level 
files. The restore can be started with any level of save tape: file-save, 
account-save, update-save, or transaction logging tape. However, if the 
restore is started with a tape created by either an update-save or transaction 
logging, that tape must contain the creation of the file. 

When RESTORE-FILE is invoked without the A option, the following 
prompt is displayed: 
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Account name on tape: 


Enter the name exactly as it is on tape. The following prompt is 
displayed: 

File name: 


Enter the file name exactly as it is on tape. RESTORE-FILE searches for 
the account and file and restores the DICT and any associated DATA 
sections of the file. When the restore is finished, the following message 
is displayed: 

Restore completed. 

The system returns to TCL unless the U option is specified, in which 
case the following prompt is displayed: 

Update/transaction tapes (Y/N)? 

If there are no additional update or transaction tapes to be applied, enter 
N to return to TCL. 

If there are additional update or transaction tapes to be applied, enter Y. 
The data restore options are displayed, similar to the following: 

Data restore options: 

U - Unload tape 

n - Skip tape forward , n’ files 

Tn - Switch to tape drive ! n f 

Type option and press <CR>, or just press <CR> to 
continue: 


To unload the current tape, enter U. As the tape is rewound and 
unloaded, the data restore options are redisplayed. When the tape is 
unloaded, mount the next tape and press RETURN. (If the next tape is 
on a different drive, enter Tn, where n is the tape drive number.) A 
tape label similar to the following is displayed: 


L 2000# time date 
Seq# of this data 
Seq# of last data 
Is this the right 


Transaction log 
tape: 0 0 

tape: 0 0 

tape (Y/N)? 


-01 

0 1 

0 0 
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Available 

See Also 


If the correct tape has been mounted, enter Y. If the correct tape has not 
been mounted, enter N; the prompt is redisplayed. Mount the correct 
tape and enter Y. 

When the correct tape is mounted, RESTORE-FILE searches for the 
account and file and applies any updates. When the end of the tape is 
reached, messages and a prompt similar to the following are displayed: 

Restore completed. 

Account: acctname -- was found 

File: filename -- was found 

Update/transaction tapes (Y/N)? 

If there are no additional update or transaction tapes to be applied, enter 
Y. The data restore options are displayed as noted above. 

On Any user account. 


ACCOUNT-RESTORE 

SEL-RESTORE 
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Syntax 

Description 


REV displays the revision levels of the various software and firmware 
components of your system. 


REV 


REV displays the revision levels of bisynchronous and asynchronous 
communications software, firmware, kernel software, ABS (system 
software), Diagnostics Monitor, and Engineering Change Orders (ECOs) if 
installed. 

REV displays revision information in the following format: 


Bisync rev. d.dd 

Firmware rev. xx 

Kernel rev. dddd 

Async rev. ddd 

Abs rev. dddaa 

Diags rev. ddd 

ECOS Loaded dd 


where: 

d decimal digit 

x hexadecimal digit 

a alphabetic character 

Bisync rev. Indicates the revision level of the bisynchronous 

communications software. This field is 
displayed only on systems with bisynchronous 
hardware. 

Firmware rev. On Ultimate Bull 6000/7000 and LSI systems, 
refers to the version of firmware in 
programmable read-only memory (PROM) chips 
on an Ultimate processor board. This value does 
not change until the hardware is updated with 
different PROMs. 

Kernel rev. Indicates the version of the kernel software. 
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Async rev. Indicates the version of the asynchronous 

software. 


Abs rev. Indicates the system revision number.of the 

operating system currently loaded on the 
computer. You can use the Abs rev. to identify 
which Boot or SYS-GEN tape was last used to 
coldstart or file-restore the system. 

Diags rev. Specifies the revision level of the Diagnostics 

Monitor. 


ECOS Loaded Indicates number of ECOs that have been applied 
to the system. If there are no ECOs, this field is 
not displayed. 


: REV J 


Display system revision information. 

F i rmwa re rev . 

7A 


Kernel rev. 

853 


Async rev. 

2534 


Abs rev. 

210D 


Diags rev. 

3970 



Available On sysprog or security account. 
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RP-ATT 

Syntax 

Description 


2-316 


/"X 


RP-ATT attaches a virtual reader or punch device. 

RP-ATT device{=n} 

device Can be one of the following: 

R D R Attaches a virtual reader device. 

PUNCH Attaches a virtual punch device. 

=n Specifies the number of the reader or punch device (0 

through 7) to attach. If omitted, the default is the next 
available reader or punch device. 


A reader or punch device must be explicitly attached before it can be 
used to read or punch virtual card images. 

Note: Only one reader and one punch device can be attached to a line 

at any one time. 

After a successful attachment, the following message is displayed: 

[807] RDR (or PUNCH) n attached (CUU=xxx) 

where: 

n Reader or punch device number. 

xxx Virtual device channel and unit number for VM. 

Once a reader or punch device is attached, it remains attached until 
detached with RP-DET, or log off. 

To spool data to the reader or punch, use the #CP command. 
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Available 


See Also 


:RP-ATT RDR=0J 


[807] 

Reader 0 attached 

(CUU=040). 

: RP-ATT PUNCHJ 


[807] 

Punch 0 attached 

(CUU=045). 


On Any user account with privilege level 1 or greater on Ultimate S/370 and 
S/390 systems. 


#CP 

RP-DET 

RP-PUNCH 

RP-READ 
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RP-DET 


Syntax 


Description 


Available On 


See Also 


(f X 


RP-DET detaches an attached virtual reader or punch device. 


RP-DET device 


device Enter one of the following: 

R D R Detaches a virtual reader device. 

PUNCH Detaches a virtual punch device. 


RP-DET detaches the current reader or punch. Once a reader or punch 
device is detached, it cannot be used to read or punch virtual card 
images until it is specifically attached via RP-ATT. 


:RP-DET RDRJ 



Any user account with privilege level 1 or greater on Ultimate S/370 and 
S/390 systems. 


#CP 

RP-ATT 

RP-PUNCH 

RP-READ 
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RP-PUNCH 


Syntax 


6985-3.2 


RP-PUNCH takes the items from a file, produces one or more virtual 
cards in fixed-length EBCDIC format or Ultimate format, and passes the 
cards to the VM spooler for distribution. 


RP-PUNCH filename itemlist {(recsize{-blksize}} 

RP-PUNCH filename itemlist (U 

filename Specifies the file from which RP-PUNCH takes 

items. 

itemlist Specifies one or more explicit item-lDs, or an 

asterisk (*) to specify all items in the file. Can be 
omitted if a select-list is present. 

(recsize-blksize Specifies the fixed-length in bytes of the output 
records and blocks, separated by a hyphen. If 
omitted, the default of 80-80 is used. If the 
blksize is omitted, the default is the specified 
recsize. 

If the specified recsize is not a multiple of 80, 
then blksize can be used to optimize the number 
of 80-byte card images produced to transfer 
records. Blksize must be a multiple of recsize, 
and for optimization, it is recommended that it be 
a multiple of 80. For example, 70-140 is valid, 
but 70-560 is optimized. 

Selecting a blksize greater than recsize permits 
the compression of records into card images 
within a block, thereby decreasing the number of 
card images required to transfer a record. 

(U Specifies Ultimate-to-Ultimate file transfer. This 

eliminates the need for the field definition 
prompts. 
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Description 


Use RP-PUNCH to move data between virtual machines on the same host 
system, or on a network connected via a Remote Spooling 
Communications Subsystem (RSCS) or other network managers. 

The punch device must be attached with RP-ATT before RP-PUNCH can 
be used. 

Use the RP-PUNCH recsize-blksize format to transfer data to a non- 
Ultimate virtual machine. Use the RP-PUNCH (U format to transfer data 
from one Ultimate system to another. 

When using RP-PUNCH with the U format, no attribute field formatting is 
needed, since the destination machine is also an Ultimate system. The 
items are transferred in Ultimate format directly to the virtual cards. 

When using RP-PUNCH with the recsize-blksize format, the system 
issues a series of dash prompts to specify which fields are to be 
transmitted and the location of those fields in the record. The responses 
that describe the fields to be output in the record must be entered in the 
following format: 

ta(s,1) { c} 

where: 

t Field type; can be one of the following: 

L Left-justified. Pads with blanks on the right. 

R or T Right-justified. Pads with blanks on the left. Characters 
are translated to EBCDIC per the standard translation table. 

N Numeric field. Allows the first character on the left to be 
a minus sign (-); if so, the field is padded with zeros on 
the left and the minus sign is placed over the rightmost 
digit. This is known as packed format. 

Note : If a field is longer than the size specified in the l parameter 

below, field types N, R, and T are truncated on the left, and 
field type L is truncated on the right. 

a Attribute number. This is the position of the attribute in the item; 
same as A/AMC on line 2 of the attribute definition item. 
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s Start position on record (in range 1- recsize). The attribute byte 
is placed at this field position in the record. If the start position 
of a field is greater than the record size, the field is ignored. 

1 Length of field. This is the number of bytes that the attribute 
uses in the record. If the length of a field plus the start position 
(see s above) exceeds the record size, the field is truncated at the 
record size. 

c Conversion (optional). This is specified only if the attribute has 
a conversion code. For example, MD2 for decimal value with 
two fractional digits, or D2 for a date in MM/DD/YY format. 

The conversion code is enclosed in colons if the conversion is to 
external format; for example, :MD2,: and :D2/: . 

The code is enclosed in semicolons if converting to internal 
format (not normally used); for example, ;MD2,; and ;D2/; . 

The following information shows how RP-PUNCH would be used for a 
file called TEST-FILE: 

Card Record Layout: 


Fields 

<-NAME- 


<-DATE-XPRICE> <QY > 



1 

2 

3 4 5 5 

6 

Positions 

12334567890... 

...9012: 

34 5 67 89012 34 567 8 901234 5 . . 

.0 




end-of-record 

t 


Note: The card record contains 60 bytes (1-60). Only positions 30- 
34,50, and 55-60 are blank. Records are blocked 8 (8 
records to a block). 

File Layout: 


Field: 

A/AMC 

Conversions 

PRODUCT NAME 

1 


PURCHASE PRICE 

4 

D2 / 

UNIT PRICE 

5 

MD2, 

QUANTITY 

11 
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RP-PUNCH 


Available On 


See Also 


PROC to format TEST-FILE: 


001 PQ 

002 ** SAMPLE PROC 
003 HRP-ATT PUNCH 
004 P 

005 HSSELECT TEST-FILE WITH DATE GT 02/26/87 
006 STON 

007 HRP-PUNCH TEST-FILE (60-480)< 

008 HL1(1,29)< 

009 HR4(35,8):D2/:< 

010 HR5(43,7):MD2,:< 

Oil HN11(51,4)< 

012 H< 

0133 P 


TCL example: 


: RP-PUNCH DICT TEST-FILE 'ITEMA ' 'ITEMB ' (60-480)J 

-LI(1,29) J 

-R4(35,8) :D2/ : J 

-R5(43,7):MD2,:J 

-Nil(51,4)J 


Any user account with privilege level 1 or greater on Ultimate S/370 and 
S/390 systems. 


RP-ATT 

RP-DET 

RP-READ 

The following documents are available from IBM documents (Virtual 
Machine/System Products): 

Document GC19-6200: VM/SP Planning Guide 
Document GC20-1816: RSCS User's Guide 
Document GH24-5003: RSCS Specifications 
Document GH24-5004: RSCS Networking 
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RP-READ 


Syntax 


Description 


RP-READ reads virtual card images that have either fixed-length records 
and fields in EBCDIC or ASCII, or Ultimate formatted file data, and stores 
the data in a file. 


RP-READ filename (recsize-blksize{,options} 

RP-READ filename (u{,options} 


filename 

(recsize-blksize 


(u 


, options 
A 


I 

K 

O 

R 


Specifies the file into which the read items are 
placed. 

Specifies the fixed-length (number of bytes) of 
the input records and blocks, separated by a 
hyphen. 

Specifies Ultimate-to-Ultimate file transfer. This 
eliminates the need for the field definition 
prompts. 


Specifies data is already in ASCII; if omitted, 
EBCDIC is assumed and the data is converted to 
ASCII. 

Displays item-IDs as the records are loaded. 

Generates item-IDs as 6-digit sequential numbers. 
Used when the item-ID is not present in the data. 

Overlays existing items. 

Rejects entirely any item that contains invalid data 
such as non-numeric characters, including 
spaces, in a numeric field. 


Note: Only the I and 0 options can be used with the (U) format. 


Use RP-READ to receive data sent by another virtual machine on the 
same host system, or on a network connected via a Remote Spooling 
Communications Subsystem (RSCS) or other network manager. 
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The reader device must be attached with RP-ATT before RP-READ can be 
used. 

Use the RP-READ recsize-blksize format to read data from a non- 
Ultimate virtual machine. Use the RP-READ U format to read data being 
transferred from one Ultimate system to another. 

When using RP-READ with the U format, no attribute field formatting is 
needed, since the destination machine is also an Ultimate system. The 
items are read in Ultimate format directly from the transferred records. 

When using RP-READ with the recsize-blksize format, the system issues 
a series of dash prompts to specify how to divide the input records into 
fields and where to place the fields as attributes in the item being 
created. 

The first dash prompt expects the item-ID, unless the command has the K 
option. In that case the first dash prompt expects the first attribute. 

Each subsequent dash prompt relates to the next attribute to be loaded in 
the current item. If an attribute is not to be loaded from the transmitted 
data, specify S to skip that attribute. Multiple attributes can be skipped 
by entering a series of S responses on separate lines, or by entering Sn, 
where n is the number of sequential attributes to skip. 

RP-READ builds an item, attribute by attribute. Each attribute can be 
built by simple input record references, user-entered constants, 
concatenations, and/or conversions. Use the following format to enter 
an input record reference that describes an attribute to be loaded: 

t (s f 1) {c} 

where: 

t attribute type; can be one of the following: 

L Left-justified. Removes trailing blanks. 

R Right-justified. Removes leading blanks. 

P Packed decimal. Removes high order zeros after 
conversion. 

N Numeric. Must contain only digits 0-9 and sign digit. 
Removes high order zeros. 
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RP-READ 


s Start position on record (in range 1- recsize). 

1 Length. This is the number of bytes that the attribute uses on the 

card. 

c Conversion (optional). This is specified only if the attribute has 
a conversion code. For example, MD2 for decimal value with 
two fractional digits, or D2 for a date in MM/DD/YY format. 

The conversion code is enclosed in colons if the conversion is to 
external format; for example, :MD2,: and :D2/: . 

The code is enclosed in semicolons if converting to internal 
format (not normally used); for example, ;MD2,; and ;D2/;. 

If a constant should be stored into an attribute (not loaded from the input 
data), enter the literal enclosed in single quotes (as in ’CA') or in double 
quotes (as in "CA"). 

Any simple input record reference can have a conversion (usually to 
internal format). If the field value in the record is in external format, the 
conversion to internal format is specified by enclosing the code in 
semicolons (;). If the conversion is from internal format to external 
format, the code is enclosed in colons (:). For example, use the 
following format to convert an 8-character external date to internal 
format.: 

R(52,8);D; 


Concatenations can be built by combining input record references with 
input record references that have conversions and with constants. 
Concatenation is indicated by using an asterisk (*). For example the 
following builds a date by inserting slashes between each pair of 
characters stored in positions 52/53 and 54/55 and 56/57 on the input 
record: 

R(52,2)*/*R(54,2)*/*R<56,2) 

The following information shows how this command would be used in 
a proc for a file called INVENTORY-MASTER: 
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Card Record Layout (Input Record =100 bytes): 




Data 0015001 


00525660 

12 

FLY WHEEL CEN 


1 

2 

22 3 

4 5 

Position 12345678901234567890123456789012345678901234567890 

Data TER 

JC200 040679. 

. PPL02257 0 

. . C-53 0007 7 6J 

5 

6 

7 

8 

9 1 

Position 12345678901234567890123456789012345678901234567890 

Field Name 


Position 

Length 

Type of Field 

PART NUMBER 


1-7 

7 

Numeric; no decimal 

PRICE 


13-20 

8 

Numeric; 5 decimal 

SITE CODE 


23-24 

2 

Alphanumeric 

DESCRIPTION 


38-62 

25 

Alphanumeric 

CREATION DATE 


64-69 

6 

MMDDYY 

COST 


70-74 

5 

Packed numeric; 5 decimal 

SALES TO DATE 


75-80 

6 

Numeric; no decimal 

MISC-CODE 


86-92 

7 

Alphanumeric 

MISC-NEG 


93-100 

8 

Negative number 


Sample PROC for INVENTORY-MASTER File 


001 

PQ 




002 

* SAMPLE PROGRAM RP-READ 




003 

STOFF 




004 

RO 




005 

HRP-READ INVENTORY-MASTER 

(100-100, 

0 ,1) 


006 

STON 




007 

HL(1,7)***L(23,2)< 

Item- 

•id 

PART# * SITE 

008 

HL(38,25)< 

Attr 

1 

DESCRIPTION 

009 

HS3< 

At t r 

2-4 

Skip (null) 

010 

HP (70,5)< 

At t r 

5 

COST; 5 packed decimal 

Oil 

HN (13,8) ;MD35;< 

At t r 

6 

PRICE;3 decimal 

012 

HS< 

Attr 

1 

Skip (null) 

013 

HL(64,2) 

Attr 

8 

CREATION DATE 

014 

H*/* 



from MMDDYY to 

015 

HL(66,2) 



MM/DD/YY to 

016 

H*/* 



internal format 

017 

HL(68,2);D;< 



via conversion 

018 

HL (86, 7) < 

Attr 

9 

MISC-CODE 

029 

HN(93,8)< 

Attr 

10 

MISC-NEG 

020 

HS1 < 

Attr 

11 

Skip (null) 

021 

HN(75,6)< 

Attr 

12 

SALES TO DATE 

022 

P 






2-326 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


6985 - 3.2 







RP-READ 


Available 


See Also 


6985-3.2 


Loaded Record in INVENTORY-MASTER File - Stored output record: 


0015001*12 (item- ) 


001 

FLY WHEEL CENTER 

JC200 

002 



003 



004 



005 

150504 


006 

5257 


007 



008 

8479 


009 

C-53 


010 

-7761 


Oil 



012 

22570 



On Any user account with privilege level 1 or greater on Ultimate S/370 and 
S/390 systems. 


RP-ATT 

RP-DET 

RP-PUNCH 

The following documents are available from IBM (Virtual 
Machine/System Products): 

Document GC19-6200: VM/SP Planning Guide 
Document GC20-1816: RSCS User's Guide 
Document GH24-5003: RSCS Specifications 
Document GH24-5004: RSCS Networking 
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RTD 

Syntax 


Description 


Available On 

See Also 

2-328 


RTD (Radix To Decimal) converts a specified radix number to its 
equivalent decimal value. 


RTD (r) n 

r Specifies the radix (base) in which the number n is 

expressed. Any radix from 2 to 16 is valid. If omitted, 
radix 16 (hexadecimal) is assumed. 

n Specifies the number to be converted, must be valid in 

the specified base. If n is hexadecimal, a negative 
number can be in the range FFFFFFFFFFFF to 
8000()()(X)()()()1 and a positive number can be in the range 
0 to 7FFFFFFFFFFF. If fewer than 12 hex characters are 
entered, high order zeroes are assumed. 


Use RTD to convert a value from another radix to decimal. If the value 
to convert is invalid in the specified radix, a value of zero (0) is 
returned. 


:RTD 2 10010 J 

Convert 10010 from base 2 to 

18 

decimal. 

:RTD 2 1012J 

Zero is returned since 2 in 1012 is 

0 

an illegal digit. 


Any user account. 


DTR 
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RUN 


Syntax 


Description 


Available On 


6985 - 3.2 


RUN executes a BASIC program. 


RUN filename item-iD {argument list} {(options) 

filename Specifies the file containing the program to be 

executed. 

item-iD Specifies the name of the program to be 

executed. 


argument list Parameters that must be passed to the program. 


(options 

A Inhibits entry to the BASIC debugger under all 

error conditions. 

D Causes the BASIC debugger to be entered before 

the start of program execution. 

E Forces the program to enter the BASIC debugger 

when an error occurs. 

I Inhibits initialization of data area when RUN is 

invoked by a BASIC CHAIN statement. 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 

S Suppresses run-time warning messages. 


For further information on RUN, please refer to the BASIC Language 
Reference Guide. 


Any user account. 


Ultimate System Commands Guide 2-329 

Confidential and Proprietary to The Ultimate Corp. 



RUNOFF 


RUNOFF 


Syntax 


Description 


Available On 


2-330 


RUNOFF executes the RUNOFF program to output formatted text items 
prepared by the Ultimate Line Editor. 


RUNOFF filename {itemlist} {(options) 


filename Specifies the name of the file to be formatted. 


itemlist 

(options 

C 

I 

J 

N 

Nn 

P 

S 

u 


Specifies one or more explicit item-lDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 

Inhibits CHAIN and READ. 

Displays next item-ID. 

Suppresses highlighting. 

Specifies no automatic end-of-page waiting. 

Overprints n times for boldface. 

Routes output to the spooler. 

Suppresses boldface and underlining at terminal. 

Prints all uppercase. 


For further information on RUNOFF, please refer to Appendix D of the 
Guide to the Ultimate Editors. 


Any user account. 
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RUNPROC 

Syntax 

Description 

Available On 
See Also 


6985 - 3.2 


RUNPROC executes a PROC from a specified file. 

RUNPROC filename procname {parameters} 

filename Specifies the file that contains the PROC. 
procname Specifies the name of the PROC to be executed, 
parameters Specifies parameters required by the PROC. 

Use RUNPROC to execute a PROC from any file. The PROC does not 
have to be defined in the Master Dictionary of the account. 

:RUNPROC DICT SYSPROG-PL LIST-PLOT-DEVICES (PJ 


Any user account. 


Ultimate PROC Reference Guide. 
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S-DUMP 


Syntax 


Description 


Available On 


2-332 


S-DUMP is an Ultimate RECALL command that dumps the contents of a 
specified file from disk to tape in a sorted sequence. 


S-DUMP filename {itemlist} {sel-criteria} {HEADER 
"name"} {sort-criteria} {{options} 


filename Specifies the file to be dumped to tape. 

itemlist Specifies one or more explicit item-IDs. If 

specified, each item-lD must be enclosed in single 
quotes, double quotes, or backslashes. If 
omitted, the command acts on the current select- 
list, or on all items in the file if no select-list is 
present. 


sel-criteria Conditions that must be met by an item in order 

for it to be sorted and dumped. Also known as a 
WITH clause. 

HEADER "name" Specifies a tape label "name." 

sort-criteria Specifies the sorting sequence. Also known as a 

BY clause. 

(options 

H Suppresses the tape label. 

I Suppresses listing dumped items to the terminal. 


For further information on S-DUMP, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 


Any user account. 


Ultimate System Commands Guide 6985-3.2 

Confidential and Proprietary to The Ultimate Corp. 



S/1-DUMP 


S/1-DUMP 


Syntax 


Description 


S/l-DUMP dumps the Series/1 internal memory into a specified disk file. 


S/l-DUMP filename item-lD (n 

filename Specifies the destination file; requires a modulo of at 
least 101,1. 


item-lD Specifies a unique item in the filename. The item-lD is 
used as a prefix for items written to the file containing 
data from the Series/1. This can be any unique string, 
and could contain information about which S/1 had the 
failure. Typically this prefix is xxxmmdd, where xxx is 
the real address of the S/1, mm is the month, and dd is 
the day. 

(n Specifies a device number from 0-3. 


When S/l-DUMP is invoked, the system displays the item-IDs of the 
items as they are written to the destination file. When the dump is 
completed, the Series/1 checks certain components. 

If the S/l-DUMP does not encounter any errors, it automatically 
reinitializes the system. Otherwise, there is a flashing error code in the 
S/1 front panel lights, and the terminals cannot operate. 

If S/l-DUMP does not automatically reinitialize the system, you must 
reinitialize via an S/l-LOAD command. You should also T-DUMP the 
destination file and send it to the Ultimate TAG for diagnosis. 

The Series/1 processor has an internal trace table that traces I/O requests 
and interrupts from both the terminals and the channel (host) attachment. 
This table, which is dumped by S/l-DUMP, aids in diagnosing any 
runtime problems encountered. 
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S/1-DUMP 


Available 

See Also 


2-334 


:S/1-DUMP 

ULTIMATE 

BC01225 

(2 J 

:S/1-DUMP 

YCOMPANY 

AC01224 

(1J 


On SYSPROG or SECURITY account on Ultimate S/370 and S/390 systems. 

S/1-LOAD 
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S/1-LOAD 


S/1-LOAD 

Syntax 

Description 


Available On 

See Also 

6985 - 3.2 


S/1-LOAD reinitializes a Series/1 front-end asynchronous 
communications processor. 

S/l-LOAD (n 

(n Specifies a device number from 0-3. 


Use S/l-LOAD to reinitialize a Series/1 front-end processor, such as 
when all the terminals connected to a particular S/1 are not working 
properly, but the computer is operating. 

S/l-LOAD clears the information between the terminals connected to the 
S/1 and the computer, then reloads the communications software. 
Finally, it restarts the communications between the terminals and the 
computer. The screen on each terminal is cleared and the following 
message is displayed: 

VERSION X.YY 

where: 

X.YY Version code for the Series/1 programs. 

When you press RETURN at each terminal, the terminal restarts its 
screen display at some point just prior to when the S/l-LOAD is 
requested (probably in the debugger). To continue, enter G. 

Note: To avoid loss of AutoBaud functions, do not press <BREAK> 

until communications have been re-established. 

All lines come up at 9600 baud unless the baud rate of a line has been 
set via SET-BAUD or in DICT ACC. 


SYSPROG or SECURITY account on Ultimate S/370 and S/390 systems. 


S/1-DUMP 


Ultimate System Commands Guide 2-335 

Confidential and Proprietary to The Ultimate Corp. 


SAVE 


SAVE 


Syntax 


2-336 


SAVE performs a file-save. SAVE is executed by each of the file-save 
processes (file-save, account-save, and update-save), or can be called 
directly from TCL. 


Save {(options) 

(options 

A Saves all files regardless of the file save option (DX, DY, 

DV, or DW) specified in the D/CODE in attribute 1 of the 
file definition item. 

B Specifies backward-release compatible (pre-190 release); 

used when the file save will be restored to a pre-190 
system. No Rev. 190 and above file information is 
saved to tape, including indexes. Does not save items 
larger than 32 k (extended-format items), but does 
display their item-IDs. Items in extended-format smaller 
than 32 k are saved in regular item format. 

Note: When using the B option, separate any items over 32 K 

into multiple items. 

D Saves the file area. If omitted, no files are saved. 

E Does not save file indexes to tape. 

F Displays the file names as they are saved. If omitted, 

only the SYSTEM file and the account names are 
displayed. 

G If Group Format Errors (GFEs) are detected, the system 

truncates the group at the end of the last good item. It 
also attempts to fix the links between the frames and 
changes an extra segment mark in an item to X’DF. (If 
the S option is specified, GFEs are logged in the STAT- 
FILE regardless of the G option. 

I Saves an individual account. Issues a prompt for the 

account name. 
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SAVE 


Description 


L When used in conjunction with the I option, sends a 

message to the logger telling it to end the current log tape 
and start another. Has no effect unless the I option is 
also specified and transaction logging is currently active. 

P Routes output to the spooler. 

R Resets the group-updated flags as files are saved. This 

option is normally used as part of a FILE-SAVE or PART- 
UPDATE-SAVE. If present, the SEQ# for the R-option is 
incremented. 

S Stores one STAT-FILE item for each file saved. After the 

file-save, the STAT-FILE contains file statistics that can be 
listed and used to reallocate files. (See FILE-SAVE, LIST- 
FILE-STATS, and REALLOCATE commands.) 

T Routes file-save output to magnetic tape; if omitted, 

nothing is written to magnetic tape. However, if the S 
option is present, the STAT-FILE is still updated. Issues 
prompt for tape label name: “file-save tape label =”; this 
name is written to tape as part of the tape label. 

U Specifies update-save. If omitted, a full file-save is 

assumed. If used, the SEQ# for the update-saves is 
incremented. If omitted, the SEQ# for full file-saves is 
incremented (unless the Z option is present). 

V Ensures that files whose D-pointers have a D/CODE of DV 

are saved. Normally DV is treated the same as DX. 

W Ensures that files whose D-pointers have a D/CODE of 

DW are not saved (treated like DX). Normally these files 
are saved. 

Z Suppresses SEQ# incrementing, and creates a tape with 

all-zero SEQ# values. This option is used for transfers of 
current system to another system, and for making SYS- 
GEN tapes. 


Ultimate recommends that only experienced users execute the SAVE 
command. Instead, use the SYSPROG file-save menu, or one of the 
following file-save PROCs for file-save operations: 
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SAVE 


• SYS-GEN 

• FILE-SAVE 

• ALL-UPDATE-SAVE 

• PART-UPDATE-SAVE 


Create a SYS-GEN tape. Same as SAVE 
(D,F,G ,S,T,Z) 

Full file-save. Same as SAVE 
(D,F,R,S,T) 

Complete update-save, does not reset 
update flags. Same as SAVE (D,F,T,U) 

Partial update-save, does reset update 
flags. Same as SAVE (D,F,R,T,U) 


Or, use the file-save menu from the SYSPROG account. 


Unless the A option is used, SAVE does not save files whose file 
definition items have a DX as their D/CODE in line 1. Therefore, any 
data file, dictionary, or account can be exempted from file-saves. The 
STAT-FILE does not reflect these files. 


SAVE does save files whose file definition items have a DY code, but, 
unless the A option is used, none of the items in the file are saved. For 
example, the data section of STAT-FILE has a D/CODE of DY because the 
data is not valid after a file-restore and does not need to be saved. 


If the file definition item for the dictionary has a D/CODE of DY, none of 
the items in the dictionary (except D-pointers) are saved. However, the 
data sections are still saved unless the file definition item for a data 
section has a DY. STAT-FILE includes the number of items in all files 
with DY as their D/CODE. 

During update-saves, groups marked for reallocation (with a reallocation 
parameter in the file definition item) are always saved if the new modulo 
and separation are to be different from the existing ones. 

Also, any DC and DZ files are saved. These file types are supported for 
compatibility with older systems and software releases, but they have no 
special meaning in current Ultimate system releases. DCX and DCY 
files, if any, are processed as DX and DY files, respectively. 

During a file-save operation, SAVE locks groups as it saves them. This 
prevents transient Group Format Errors (GFEs) from occurring on other 
lines. Up to four groups at a time can be locked by SAVE. The groups 
to be locked are those that contain the following: 



V..y 
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Available 

See Also 


6985 - 3.2 


• SYSTEM dictionary pointer for the account being saved. 

• File dictionary pointer for the dictionary of the file being saved; this 
is a group in the account’s MD. 

• File data pointer for the data file being saved; this is a group in the 
file’s dictionary. 

• Data in the group currently being saved. 

If someone on another line tries to access data in a locked group, the 
terminal issuing that command hangs until the file-save finishes saving 
all items in the locked group and unlocks the group. 

At the end of each account, an end-of-file (EOF) mark is written to tape. 
The last record can be filled with blank pad characters after the end of 
valid data. 


On SYSPROG or SECURITY account. 


ALL-UPDATE-SAVE 

FILE-SAVE 

FILEOPT 

LIST-FILE-STATS 

PART-UPDATE-SAVE 

REALLOCATE 

SYS-GEN 

System Management Guide for information on file-save, update-save, 
and system generation procedures. 
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SAVE-LIST 


Syntax 


Description 


SAVE-LIST makes a permanent select-list item from a temporary select- 
list produced by SELECT, SSELECT, QSELECT, GET-LIST, or SEARCH 
with the S option. 


SAVE-LIST {listname} 

listname Specifies the name of the saved select-list. If omitted, 
the select-list is assigned a null item-ID (""). 


Use SAVE-LIST to save and catalog a select-list and reuse it as a 
permanent item in the system. 

Note: SAVE-LIST requires a file or file synonym called POINTER-FILE 

to exist in the account issuing the command. 

SAVE-LIST must be entered immediately following the command that 
created the select-list to be saved. 

SAVE-LIST catalogs the select-list. Cataloging saves the list in frames 
retrieved from the available space, and adds or updates the pointer to the 
select-list in the POINTER-FILE dictionary. 

Note: If a select-list was previously saved with the specified list- 
name, it is overwritten by any subsequent SAVE-LIST 
command that specifies the same list-name or null name. No 
warning is issued. 

After the select-list is cataloged, the system displays the following 
message: 

'list-name 1 saved - nn frames used. 

where: 

list-name Item-ID of the saved select-list. 

nn Number of overflow frames used to store the select-list. 
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SAVE-LIST 


Available 

See Also 


:SAVE-LIST CUST.LISTJ 

'CUST.LIST' saved - 3 frames used. 


On Any user account. 


DELETE-LIST 

EDIT-LIST 

GET-LIST 

Ultimate PROC Reference Guide. 

Ultimate RECALL and Ultimate UPDATE User Guide. 
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SAVE-PARITY 

SAVE-PARITY allows input of 8-bit transparent data on a specified line, 
instead of the default communication format of a 7-bit ASCII character 
plus a parity bit. 


Syntax save-parity {n} 

n Specifies the number of the line to be set to the SAVE- 

PARITY mode. If omitted, the current line is assumed. 


Description Use save-parity whenever communications require input to be 
received in 8-bit transparent mode. 

SAVE-PARITY sets the receive-data mode so that the high order bit is not 
stripped from the incoming data stream. This allows transmission of 8- 
bit transparent data. 

If the communication device does not support 8 data bits and parity 
transfers, parity must be disabled for the line with SET-BAUD. 

Once a line is set to the 8-bit mode, it remains in that mode until it is 
reset to the default by the STRIP-PARITY command. 

Note: A coldstart resets all lines to the system default mode. A 

warmstart, however, does not change the current mode on any 
line. 


: SAVE-PARITY 2J 


Available On sysprog or security account. 


See Also SET-BAUD 

STRIP-PARITY 
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SE 


Syntax 


Description 


Available On 


SE 


SE invokes the Ultimate Screen Editor. 


SE {filename} {itemlist} {(L) 

filename Specifies the name of the file to be edited. If omitted, the 
system prompts for it. 

itemlist Specifies one or more explicit item-IDs, or an asterisk (*) 
to specify all items in the file. If omitted, the system 
prompts for it. 

(L Loads function keys. 


For further information on SE, please refer to the Guide to the Ultimate 
Editors. 


Any user account. 
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SEARCH 


Syntax 


Description 


2-344 


/f "\ 


SEARCH examines one or more items for occurrences of one or more 
specified character strings. 


SEARCH filename {itemlist} {(options} 


filename Specifies the file containing the items to be searched. 


itemlist Specifies one or more explicit item-IDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 

(options 

I Searches the item-IDs as well as the item contents for the 

specified search string. 

N Specifies no automatic end-of-page waiting. 


P Routes output to the spooler. 

S Generates a select-list containing the item-IDs of the 

items that match the search string. 

U Ignores distinction between uppercase and lowercase 

characters in the search strings and items. Ouput is in all 
lowercase letters. 



Use SEARCH whenever you need to locate one or more specific 
character strings in file items. As SEARCH processes each item, it 
reports on the occurrence of the string, or builds a select-list. 

When SEARCH is invoked, it displays the following prompt: 


String? - 


Enter the first character string to be searched for. The String? prompt is 
redisplayed. An additional string can be entered at each occurrence of 
the prompt. To end display of the String? prompt, press RETURN 
without entering a string. 
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SEARCH 


Available 
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A search string can contain blanks and one or more wild card ( A ) 
characters. The wild card character can be used anywhere in the search 
string, except as the first character of the string. 

The system searches each item for each of the specified search strings. 
If a match is found, SEARCH displays the associated item-lD, followed 
by the matching information. 

If the S option is used, SEARCH builds a select-list of each item 
containing the specified string. Note that even though an item can 
contain multiple search strings, no item-ID is added more than once to a 
select-list. 


SEARCH MYFILE ITEM1 ITEM2J 

String?- 

TAPE'' J 

String?- 

BLOCK= AA J 

String?- 

J 

ITEMl 

003 TAPE1 

IS ON-LINE AND READY. 

020 TAPE2 

IS ON-LINE AND READY. 

BLOCK=8192 


ITEM2 

004 TAPES 

ARE ALL ORDERED. 


On SYSPROG or SECURITY account. 
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SECURITY 

Syntax 

Description 


2-346 


SECURITY displays the main menu of the SECURITY account. 


SECURITY 


SECURITY displays the Ultimate Accounts Manager menu (also known 
as the Security Main Menu). 

Note: SECURITY only works in the SECURITY account. 

The Ultimate Accounts Manager menu allows the system manager to 
establish system and terminal security, create, rename, or delete user 
accounts, and display terminal logon failures. The system manager can 
also access the on-line security documentation from this menu. 


When invoked, SECURITY displays the following menu: 


****************************************************** 

* The ULTIMATE Accounts Manager * 

* Version n date * 

****************************************************** 

1. System Security Specifications 

2. Terminal Security Specifications 

3. Create/Update an Account 

4. Rename an Account 

5. Account Save to Tape 

6. Account Restore from Tape 

7. Delete an Account 

8. Display Terminal Logon Failures 

9. Security System Documentation 

10. Delete Q-pointer Account 


Enter Selection, 'TCL', or 'OFF' 
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Available 

See Also 
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Note: For Ultimate SI370 and SI390 systems, this menu includes 
item 11, Enter Access Code for this Machine. 

At the Enter Selection prompt, enter the number of the desired option. 
The screen for the selected option is then displayed. 

To return to TCL, enter TCL. To log off, enter OFF. 


On SECURITY account. 


ACCESS-CODE 

ACCOUNT-RESTORE 

ACCOUNT-SAVE 

CREATE-ACCOUNT 

DELETE-ACCOUNT 

RENAME-ACCOUNT 

SECURITY-STATUS 

TERMINAL 

UPDATE-ACCOUNT 

System Management Guide for information on the SECURITY account 
and menus. 
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SECURITY-STATUS 

SECURITY-STATUS allows the system manager to inspect and modify 
system security parameters. 


Syntax 

SECURITY-STATUS 

Description 

SECURITY-STATUS allows the system manager to enable or disable 
assembly code operations, security features in SYSPROG, and logon 
monitoring. It also allows the system manager to reactivate lines 
disabled due to logon violations. 


When invoked, SECURITY-STATUS displays the following Security 
Feature Status Control screen: 


Security Feature Status Control 

1) Assembly Code Modification Capability (E or D) : Enabled 

2) Enable Security Features in SYSPROG (E or D) : Enabled 

3) Logon Error Recording and Control (E or D) : Disabled 

4) Number of Sequential Logon Errors Before Disablement(#):10 

5) Duration of Disablement (HH:MM:SS) :00:02:00 

6) Number of Logon Errors Per Day Before Disablement (#) :20 

7) Duration of Disablement (HH:MM:SS) : 00:02:00 

8) Reactivate Line Disabled Due to Logon Failures (#) : 

, Enter Option (#,EX,FI) : , 


Options 4-7 are the default for all lines unless otherwise specified on a 
per-line basis via the TERMINAL command. 
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SECURITY-STATUS 


Available 

See Also 


At the Enter Option: prompt, enter an option number, EX to exit without 
saving your changes, or FI to file and save your changes. 


On SECURITY account. 


TERMINAL 

System Management Guide for information on setting up system 
security. 
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SEL-RESTORE 

SEL-RESTORE selectively restores items from a file-save tape or account- 
save tape. 


Syntax SEL-RESTORE filename {itemlist} {(options} 

filename Specifies the file to which items in the itemlist should be 
restored. Also known as the destination file. 

itemlist Specifies one or more explicit item-IDs, or an asterisk 
(*) to specify all items in the file. Can be omitted if a 
select-list is present. 

(options 

A Specifies that the tape is already positioned in the desired 

account. When specified, the Account name on tape: 
prompt is not displayed. 

C Considers every item before the next D-pointer on tape or 

the end-of-file (EOF) mark for the selective restore. This 
feature ensures that data can be restored even if a D- 
pointer is damaged on the tape. You must also use the N 
option when you use the C option. 

E Restores every version of an item or items that can be 

found on tape. System-generated item-IDs will be used 
for duplicate copies of items; the original item-ID will be 
stored as attribute one of the item (attribute six for CC- 
pointer or CL-pointer items). Must be used with the U 
option; cannot be used with the O option. 

I Inhibits display of item-IDs of restored items. 

N Identifies the file on tape by its file number. If this 

option is present, the command prompts for the file 
number with the File#?” prompt. 

O Overwrites items currently on the file. 

S Skips initial forward spacing of the tape. Used when the 

restore starts at the beginning of the second or later reel 
of a file-save tape. 
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SEL-RESTORE 


Description 


U Prompts for update and transaction tapes when the 

specified items have been restored; the end of the file (or 
end of tape set if the file has not yet been found) is 
reached on a file-save, account-save, or update save tape; 
or the end of a transaction log tape is detected. 


Use SEL-RESTORE to load items from a file on an account-save or file- 
save tape. You must be logged on to the account into which the file is to 
be restored, or have a Q-pointer to the destination file. SEL-RESTORE 
assumes that the save tape containing the file has been mounted. 

Note: If SEL-RESTORE is used from a SYS-GEN tape, you must first 

execute four T-EWD commands (3 on S/370 and S/390 
systems) from the tape load point before restoring the file. 

This operation is necessary to bypass the cold-load and ABS- 
load sections on the SYS-GEN tape. 

When SEL-RESTORE is invoked (without the A or N options), the 
following prompt is displayed: 


Account name on tape? 


Enter the account name under which the file was saved on tape. The 
following prompt is displayed: 

File name? 

Enter the name under which the file was saved. 

Hint: To obtain a file listing if none is available, use a non-existent 

accountname and filename. As SEL-RESTORE searches the 
tape for this non-existent data, all filenames and their 
associated file numbers are displayed. 

If SEL-RESTORE is invoked with the N option, the following prompt is 
displayed: 

File#? 

Enter the file number from the STAT-HLE listing associated with the 
filename on the STAT-FILE listing for this file-save tape. 
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SEL-RESTORE 


Available On 
See Also 


As the tape is searched, its filenames and file numbers are displayed. 
Filenames are indented one space for account names, two spaces for 
dictionaries, and three spaces for data filenames. 

To restore both dictionary and data sections of a file, restore the DICT 
first (DICT filename). Since dictionary items follow data items, in a 
large file there can be a considerable wait between the time the file is 
found and the actual restore. 

The tape can be moved backward with T-BCK, or forward with T-FWD. 
Then SEL-RESTORE with the A or N options can be invoked. This can 
be faster than restarting the tape from the beginning when restoring both 
the dictionary and data sections of a file, or when restoring multiple 
files. 

When the restore starts at the second or later reel of a multi-reel file- 
save, and if the beginning of the tape is not at a file mark, the SEL- 
RESTORE automatically forwards to the beginning of the next file. 
However, the S option can be used to inhibit this forward spacing. 

To restore items in the SYSTEM dictionary, such as Q-pointers, use SEL- 
RESTORE with the N and C options, and File# = 1. Remember that this 
is the last file on the tape. On a multi-reel file-save, mount the last reel, 
and also use the S option. 


: SEL-RESTORE WP DOC1 (A) J 

File name? WPJ 


Any user account. 

ACCOUNT-SAVE 

ACCOUNT-RESTORE 

FILE-SAVE 

LIST-FILE-STATS 

RESTORE-FILE 

SAVE 

T-BCK 

T-FWD 

System Management Guide for information on saves and selective 
restores. 
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SELECT 


Syntax 


Description 


Available On 


6985 - 3.2 


SELECT is an Ultimate RECALL command that creates a select-list from 
specified file items. The select-list can contain item-IDs or attribute data. 


SELECT filename {itemlist} {sel-criteria} {output- 
specifications {print-limiters}} 


filename Specifies the file from which items should be 

selected. 

itemlist Specifies one or more explicit item-IDs. If 

specified, each item-ID must be enclosed in single 
quotes, double quotes, or backslashes. If 
omitted, the command acts on the current select- 
list, or on all items in the file if no select-list is 
present. 

sel-criteria Conditions that must be met by an item in order 

for it to be selected. Also known as a WITH 
clause. 


output- Specifies the attributes and values used to create 

specifications the select-list. 


print-limiters Restricts the printing of output specification to 
values that meet the limit conditions. 


For further information on SELECT, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 


Any user account. 
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SET-BAUD 


Positional 

Syntax 

Keyword 

Syntax 


SET-BAUD sets and displays the baud rate and other elements of protocol 
for lines using asynchronous communications. 


SET-BAUD {n/Z,r,c,s,p,e,x,t} {(P} 


SET-BAUD {LINE = n/Z} 

{BAUD = r} 

(DATABITS = C} 

{STOPBITS = S} 

{PARITY = p} 

{ECHO = e} 

{XON/XOFF = x) 

{TYPEAHEAD = t) 

{(P) 

Note: If parameters are omitted, SET-BAUD displays the values for 
the current line. For any parameter omitted from the 
command, its current value is used. 

SET-BAUD positional parameters and keywords are described below: 


Parameter 

n/z 


Keyword 
LINE = n/Z 


BAUD = r 


DATABITS=C 


STOPBITS=S 


Description 

Specifies the line for which baud 
rate is to be set or displayed. If 
omitted, the current line is assumed. 
Use the letter Z to display all lines. 

Specifies baud rates in bits per 
second. See Description for a list of 
valid baud rates by platform 

Specifies the character length in 
number of bits; values are 5, 6,7, or 
8 . 

Specifies the stop bit in number of 
bits; values are 1 or 2. 
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SET-BAUD 


Description 


P 


e 


x 


t 

(p 


PARITY=p Specifies the parity bit. Values for 

keyword format are ODD, EVEN, 
and NONE. Values for positional 
format are: O, E, and N. 

ECHO=e Specifies echo status. Status values 

are ON or OFF. 

XON/XOFF=x Specifies XON/XOFF status. Status 

values are ON or OFF. 


TYPEAHEAD=t Specifies TYPEAHEAD status. 

Status values are ON or OFF. 

(P Routes output to the spooler. 


Use SET-BAUD to display the current characteristics for one or all lines, 
or to set new characteristics on a line. 

Caution: SET-BAUD should he used only when the specified line is 

not active, since it can otherwise affect ongoing data 
transfer. 

When invoked without parameters, SET-BAUD displays the following for 
the current line: 

Line Line Char Stop Parity Echo Xon/Xoff TpAhead 
Speed Leng Bits 

Note: Lines on an S/370 and SI390 systems' Series! I will initialize at 
9600 baud, 8 data hits, 1 stop hit, and no parity. Lines on 04- 
way (Feature 2096) will automatically change their baud rate to 
match the terminal's baud rate; however, parity and stop hits 
do not automatically adjust. 


: SET-BAUD 10,,,EJ 

Set parity to EVEN on line 


10. 

:SET-BAUD 4 BAUD = 19200J 

Set baud rate on line 4 to 


19200. 

:SET-BAUD ZJ 

Display settings for all 


lines. 
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SET-BAUD 


Available On 


2-356 


Valid baud rates by platform are: 


Baud 

Rates 

S/370 and 
S/390 
(Series/1) 

S/370 and 
S/390 
(HIFAS) 

LSI 

Bull 

60(07000 

1400 

38400 


* 




19200 

* 

* 

* 

* 

* 

9600 

* 

* 

* 

* 

* 

7200 

* 

* 

* 



4800 

* 

* 

* 

* 

* 

3600 

* 

* 


* 

* 

2400 

* 

* 

* 

* 

* 

2000 

* 



* 

* 

1800 

* 

* 

* 

* 

* 

1200 

* 

* 

* 

* 

* 

1050 




* 

* 

600 

* 

* 

* 

* 

* 

300 

* 

* 

* 

* 

* 

200 



* 

* 

* 

150 


* 

* 

* 

* 

134 



* 

* 

* 

110 


* 

* 

* 

* 

75 


* 

* 

* 

* 

50 


* 

* 

* 

* 


SYSPROG or SECURITY account. 
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SET-DATE 


Syntax 


Description 


SET-DATE changes the system date. 


SET-DATE 

dd mon {yy{yy}} 
mm dd {yytyy}} 

dd 

Specifies the numeric form for day (1-31); a leading zero 
is not required. 

mon 

Specifies the alpha form for month. Must be the first 
three letters of the month, for example, MAR for March. 

mm 

Specifies the numeric form for month (1-12); a leading 
zero is not required. 

yy(yy) 

Specifies the desired year. If omitted, the current year is 
assumed. If present, it can be a 2-digit or 4-digit 
number. 


Note: Any non-numeric character can he used for delimiters. 


Use SET-DATE to change the system date. The result is always 
displayed as follows: 

hh:mm:ss dd mon yyyy 

If the numeric month form is used, the command assumes the first 
number entered is the month. 

The system updates the date at midnight ((X):()0:()0). 
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SET-DATE 


Available 


See Also 


2-358 


:SET-DATE 04/9/91J 

10:05:39 09 APR 1991 

: SET-DATE SEP 03 91J 

10:06:02 03 SEP 1991 

: SET-DATE 4 MAR 1991J 

10:06:34 04 MAR 1991 


On SYSPROG or SECURITY account. This command is not available on 
Ultimate S/370 and S/390 systems. 


DATE 

SET-TIME 

TIME 
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SET-FILE 


Syntax 


Description 


SET-FILE creates or updates a file synonym definition item called QFILE 
in an account’s Master Dictionary. 


SET-FILE {accountname} {filename} {systemname} {(options) 


accountname Specifies the name of the account in which the 

specified file is defined. If omitted, the system 
prompts for it; at the prompt, to use the value 
from the current QFILE item, enter a backslash 

CO. 

filename Specifies the name of the file to be used. If 

omitted, the system prompts for it; at the prompt, 
to use the value from the current QFILE item, 
enter a backslash (\). 


systemname 


(options 

O 

S 


In an UltiNet environment, specifies the system 
containing the account and file. If omitted, 
assumes the current system. 


Overwrites any existing Q-pointer called 
filename; used with the S option. 

Creates a Q-pointer called filename (as well as 
one called QFILE) if it does not already exist. 


Use SET-FILE to create a file synonym definition item, also known as a 
Q-pointer. A Q-pointer allows you to access a file in another account, or 
to define a synonym name for a file in the same account. Q-pointers 
have a D/CODE (attribute 1) value of Q. 

SET-FILE sets up an item called QFILE in the current Master Dictionary as 
a Q-pointer to the specified file. QFILE is a temporary pointer that 
changes with every SET-FILE executed in the account. To create a 
permanent Q-pointer named filename, use the S option. 

If accountname is omitted in the command statement, the following 
prompt is displayed: 
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SET-FILE 


Available 

See Also 


Account name? 

Enter the name of the account, or press RETURN to exit to TCL. 

If filename is omitted in the command statement, the following prompt 
is displayed: 

File name? 

Enter the name of the file, or press RETURN to create a pointer to the 
specified account’s Master Dictionary. 

If there is already an item in the MD with the same name as filename, 
and the S option is specified, the following message is displayed: 

[415] 'filename' exists on file. 

When the Q-pointer is successfully created, the following message is 
displayed: 

'QFILE' updated 


:SET-FILE CUSTOMER ADDRESSJ 

'QFILE' updated 


On Any user account. 


System Management Guide for information on file synonym definition 
items (Q-pointers). 

UltiNet User’s Guide. 
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SET-LANGUAGE 

SET-LANGUAGE specifies the language setting for the current line, or 
displays the current language setting for a specified line or for all lines. 


Syntax set-language { l c} 

{n} 

{?} 

Ic Specifies the two-character language code to be set for 

the current line. The default language code is US, for 
English language as used in the United States. 

n Displays language setting for the specified line. 

? Displays language setting for all lines on the system. 

Note: If parameters are omitted, the language setting for the current 

line is displayed. 


Description Use SET-LANGUAGE to display or change the current language setting. 

SET-LANGUAGE stores the current language setting in the dictionary of 
the ACC file in the item for each line. The pointers to the ERRMSG file 
and the PROCLIB file for the current user are changed to the data level 
corresponding to the current language code. 

Language codes are defined using the Ultimate UltiKit® application. 


: SET-LANGUAGE 

FRJ 


Set the language code for the 
current line to French. 

:SET-LANGUAGEJ 



Display the language code for the 
current line. 

Line # 

Language 

Code Language Name 

3 


FR 

Francais 


Available On Any user account. 
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SET-LEVEL-PUSH 


SET-LEVEL 


Positional 

Syntax 

Keyword 

Syntax 


2-362 


PUSH 

SET-LEVEL-PUSH activates or deactivates TCL level pushing. You can 
also designate function keys for push, pop, and refresh operations; set 
the output buffer size for each level; and specify a startup command to 
execute at each level push. 


SET-LEV EL-PUSH {n },{stat us},{push },{pop},{ refresh}, 
{buff},{startup} 

SET-LEVEL-PUSH {LINE = n} 

{status = status} 

{PUSH = push} 

{POP = pop} 

{REFRESH = refresh} 

{PUFFER = buff} 

{STARTUP = startup} 


N ote: If parameters are omitted, level pushing values for the current 

line are displayed. 


SET-LEVEL-PUSH positional parameters and keywords are described 
below: 

Parameter 

Keyword 

Description 

n/* 

LINE = n 

Specifies the line that should have 
level pushing parameters displayed 
or modified; * displays all lines. If 
omitted, the current line is assumed. 

status 

STATUS = 

status 

Turns level pushing ON or OFF. 

The default is OFF. 

push 

PUSH = push 

Designates a function key to 
perform the push operation. 
Allowable formats are Fn (Function 
Key n) or SFn (Shift/Function Key 
n). If omitted, the default is F6. 

You can also use <CTRL-P> to push 
a level. 
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Description 


6985 - 3.2 


Parameter Keyword 

pop POP = pop 


refresh REFRESH = 
refresh 


Description 

Designates a function key to 
perform the pop operation (go back 
one TCL level). Allowable formats 
are Fn (Function Key n) or SFn 
(Shift/Function Key n). If omitted, 
the default is F7. You can also use 
<CTRL-0> to pop a level. 

Designates a function key to 
perform refresh of the current 
screen. If omitted, the default is F8. 


Caution: Make sure that push, pop, and refresh function keys or 

CTRL key sequences do not conflict with function keys 
or CTRL key sequences of other programs that run on the 
same line. 


buff BUFFER = 

buff 


startup STARTUP = 
startup 


Specifies size in bytes of the buffer 
that captures output for each level. 
The default size is 8()(X) bytes; 
maximum size is 32000 bytes and 
minimum size is 500 bytes. Any 
output in excess of the maximum is 
discarded by the system. 

Specifies a program or command, 
including parameters, to be executed 
at the beginning of each level push. 


Note: If the startup string contains string delimiters such as single 
quotes ('), double quotes ("), or backslashes (\), the entire 
startup string must be enclosed in another, different set of 
string delimiters. 


SET-LEVEL-PUSH allows you to enable or disable TCL level pushing, and 
to specify level pushing and popping parameters. 

If the amount of data for a level to be stored in the buffer exceeds the 
capacity of the buffer, the following prompt is displayed: 
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Available On 

See Also 


2-364 


v-y 1 

Output has been lost; still PUSH <Y/N=CR> : 

To cancel the push request, press RETURN; the system continues at the 
current level. To push the level, enter Y; when you return to the current 
level, data can be missing from the screen display. 


f ~\ 

v.y 


Any user account. 


LEVEL-EXIT 

SHOW-LEVELS 

Chapter l of this document for further information on TCL level 
pushing. 


; set-level-pus hj Display level pushing settings 

for the current line. 

Port Status <PUSH> <POP> <REFRESH> Buffer Startup 
22 Off 

:set-level-push onj Turn on level pushing for the 

current line. 

Port Status <PUSH> <POP> <REFRESH> Buffer Startup 

22 On F6 F7 F8 8000 

:set-level-push 6, , , , 3200 0J Set output buffer size for line 

6 to its maximum, without 
changing other settings. 

Port Status <PUSH> <POP> <REFRESH> Buffer Startup 

6 On F6 F7 F8 32000 
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SET-LOGOFF 

SET-LOGOFF sets up a line to automatically log off if Data Set Ready 
(DSR) drops. 

Syntax set-logoff {n} 

n Line for which automatic logoff should be set. If 

omitted, the current line is assumed. 

Description Use SET-LOGOFF for a specified line to automatically log off the line 

whenever a drop in DSR, such as Carrier Detect (CD) or Clear To Send 
(CTS), is detected. 


On Ultimate 1400 systems, SET-LOGOFF also logs off the line when 
Data Terminal Ready (DTR) or Request To Send (RTS) occurs. 



Available On SYSPROG or SECURITY account on Ultimate Bull 6000/7000 systems 

and Ultimate 1400 systems. 

See Also reset-logoff 
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SET-LPTR 


SET-LPTR 

Syntax 

Description 


Available On 

See Also 

2-366 




SET-LPTR sets a specified maximum for page width (line length) and 
page depth (lines per page) on output from the line printer. 


SET-LPTR 


SET-LPTR is an alternative to using PRINTER or TERM to set page format 
for the line printer. When invoked, SET-LPTR displays the following 
prompt: 

PRINTER PAGE WIDTH (# COLUMNS)? 

Enter the desired page width (from 16-465 columns), or press RETURN 
to specify the default page width of 140 columns. The following 
prompt is displayed: 

PRINTER PAGE DEPTH (# LINES) 

Enter the desired page depth (from 0-132 lines), or press RETURN to 
specify the default page depth of 60 lines per page. When both entries 
have been made, the system displays the current line printer settings. 


: SET-LPTRJ 

PRINTER PAGE WIDTH (# COLUMNS)? 80J 

PRINTER PAGE DEPTH (# LINES)? 59J 


Terminal Printer 

Page width 

79 80 

Page depth 

24 59 

Line skip 

0 

LF delay 

1 

FF delay 

5 

Backspace 

8 

Term type 

S 


Any user account. 


PRINTER 

TERM 
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SET-STACK 


SET-STACK displays or changes parameters for the TCL stack. 


Positional 

Syntax 

Keyword 

Syntax 


SET-STACK {n},{status},{sents},{clear},(one.sent} {(P) 


SET-STACK {LINE = n} 

(STATUS = status} 

{SENTENCES = sents} 

(CLEAR= clear} 

{ON E.SENTEN CE = one.sent} 

{(P) 

Note: If parameters are omitted, SET-STACK displays the stack 
settings for the current line. 

SET-STACK positional parameters and keywords are described below: 


Parameter Keyword 

n LINE = n 

status STATUS = status 

sents SENTENCES = 

sents 

clear CLEAR = clear 


Description 

Specifies the number of the line 
for which the TCL stack should 
be set or displayed. An asterisk 
(*) sets or displays the stack 
parameters for all lines in the 
system. 

Turns the TCL stack ON or OFF 
for the specified line. Default is 
ON. When the stack is OFF, no 
commands are stacked, although 
the stack can still be displayed 
with the VIEW command. 

Specifies the number (from 1- 
120) of command statements to be 
saved in the stack. Default is 32. 

Specifies whether or not to clear 
the TCL stack at logoff; 
acceptable values are YES and 
NO, default is YES (CLEAR). 
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Description 


Available On 


See Also 


2-368 


Parameter Keyword Description 

one.sent ONE.SENTENCE = Specifies whether or not to save 
one.sent only one occurrence of a 

command statement in the stack; 
acceptable values are YES and 
NO, default is NO. Saving only 
one occurrence is useful if the 
same commands are entered 
often during a session, such as 
EDIT, COMPILE, and RUN, and 
you do not want the stack to fill 
up with these commands. 

(P (P Routes settings to the spooler. 


Use SET-STACK without parameters to display settings for the current 
line; enter parameters or keywords to change desired settings. 


:SET-STACKJ 

Display settings for the 


current line (line 1). 

Line Stacker 

Saved Clear at 

One Copy 

Status 

Sentences Logoff 

of Sentence 

1 On 

32 Yes 

Yes 


Any user account with privilege level 1 or greater. Must have privilege 
level 2 to change settings for another line. 


CLEAR-STACK 
VIEW or. (period) 

WY60 

Chapter 1 of this document for information on the TCL stack. 
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SET-SYM 

Syntax 


Description 


Available On 

See Also 


6985-3.2 


SET-SYM specifies a symbolic debugger file for use by the current line. 


SET-SYM filename {(T} 

filename Specifies the name of a symbol file containing names for 
assembly-level addresses for the current line. 

(T Indicates that the filename specified above is a 

secondary file containing symbols that are not in the 
default system debugger file (usually PSYM). If omitted, 
makes filename the primary debugger file for the line. 

Use SET-SYM to set a specified file as the debugger symbol file for the 
current line. The specified file can replace the default symbol file for 
the system debugger (usually PSYM in the SYSPROG account), which is 
set at coldstart by :DEBUG-PSYM. Or, if the T option is used, the 
specified file can be secondary to the default system debugger file to 
provide local symbols. You may wish to use a filename such as TSYM 
for this purpose. 

Once SET-SYM is executed, the debug symbolic display commands 
backslash (/) and asterisk (*) can be used. 


SYSPROG or SECURITY account. 


Ultimate Assembly Language Reference Guide. 
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SET-TERM 


Positional 

Syntax 

Keyword 

Syntax 


2-370 


(n 


SET-TERM sets the default terminal and printer characteristics for all 
subsequent logons on all terminals. 


SET-TERM {w},{d},{ls},{lfd},{ffd},{bs},{prw},{prd}, 
{code} 


SET-TERM {WIDTH = w} 

{DEPTH = d} 

{LINES KIP = Is} 

{LFDELAY = Ifd} 

{FEDELAY = f fd} 

{BACKSPACE = bs} 

{PR WIDTH = prw} 

{PR DEPTH = prd} 

{TYPE = code} 

N ote: If parameters are omitted, SET-TERM displays settings for the 
current line. 


SET-TERM positional parameters and keywords are described below: 
Parameter Keyword Description 

w WIDTH =w Specifies the number of characters per 

line on the terminal, up to 465. 


d 

Is 


Ifd 


DEPTH=d Specifies the number of lines per screen 
on the terminal. 

LINESKIP=Is Specifies the number of blank lines 
displayed before the stall of the next 
screen page. 

LFDELA Y=lfd Specifies the number of delay or idle 
characters to output following each 
RETURN or line feed. Used on terminals 
that require a pause after RETURN or line 
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Parameter Keyword Description 

feed because the CPU generates 
characters faster than the terminal can 
accept them. 

ffd FFDELAY=ffd Specifies action to take when a 

temiinal or printer new-page condition 
occurs. (Temiinal new-page occurs at 
term-page-depth + term-line-skip. 
Printer new-page occurs at lptr-page- 
depth.) 

Terminal actions include no action, or 
sending a dear-screen character 
sequence and n delay characters. 

Printer actions include no action, or 
sending a top-of-form character 
sequence. 

If the value entered is 0 (zero), no 
clear-screen or top-of-form character 
sequence is sent to either the terminal 
or the printer. If the value entered is 1, 
no clear-screen character sequence is 
sent to the terminal, but a top-of-form 
character (X'OC') is output whenever a 
new printer page begins, as determined 
by lptr-page-length. 

If the value entered is greater than 1, 
the temiinal screen is cleared at the 
beginning of each terminal page, and a 
top-of-form is output at the beginning 
of each printer page. For temiinal 
output, the value entered generates that 
number of delay or idle characters to 
allow the clear-screen character 
sequence to be processed. The clear- 


Ultimate System Commands Guide 2-371 

Confidential and Proprietary to The Ultimate Corp. 


SET-TERM 


Parameter 


bs 


prw 


prd 


code 


Parameter 


Keyword Description 

screen character sequence is 
determined by the terminal-code. 

BACKSPACE = Specifies the decimal number whose 
bs value corresponds to an ASCII 

character. This is used as an alternate 
backspace character in normal input 
mode. An ASCII backspace (<CTRL- 
H> or X’08'), is always interpreted as a 
backspace, bs is always echoed on the 
terminal whenever it is entered. 

PRWlDTH=prw Specifies the number of characters per 
line on the printer. 

PRDEPTH=prd Specifies the number of lines per page 
on the printer. 

TYPE=code Specifies the type of terminal, which 

determines functions such as the dear- 
screen character sequence, as well as 
cursor addressing and other 
characteristics specified by such means 
as the BASIC @ function or the PROC T 
statement. Codes are: 

Keyword Description 

A ADDS Regent 40 (25-line CRT) 

B Digital VT241 Color Graphics' CRT 
C ADDS Viewpoint Color 

D Digital VTl(K) 

E Digital VT200 Series 8-bit mode 
F IBM 3270 terminal 

G IBM 3101 

H Honeywell VIP-7200 

J Heathkit in ANSI mode 

L Liberty Freedom-200 

M Minitel 

P IBM Personal Computer 
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Description 


Q Wyse Wy-50/Ultimate ULT-50 in 
enhanced viewpoint emulation mode- 
extended version 
R ADDS Regent 25 
S Wyse WY-60 in Native mode 
T Wyse WY-50/Ultimate ULT-50 in 

enhanced viewpoint emulation mode- 
extended version 
U Ultimate CRT (Volker-Craig) 

V Ultimate VDT (ADDS Viewpoint) 

W Wyse WY-50 or ULT-50 Enhanced 

Viewpoint 

X Wyse WY-50 or ULT-50 Native mode 

Y Wyse WY-85 in VT220 7-bit mode 
Z HP 700/92 

Note: If only terminal code is to be changed, all other parameters can 
be omitted from the command. 


Use SET-TERM to preset the entire system’s default terminal and printer 
characteristics at one time. 

When invoked without parameters, the current terminal settings are 
displayed as follows: 


Terminal 
Page width: 79 
Page depth: 24 
Line skip : 0 

LF delay : 1 

FF delay : 5 

Backspace : 8 

Term type : S 

SET-TERM sets all specified parameters and retains the current values for 
any null parameters. All non-keyword parameters are interpreted by 
their position in the command. 

The current TERM settings can be displayed via the TERM command, or 
by entering SET-TERM without any parameters. 


Printer 

132 

60 
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SET-TERM 


Available 

See Also 


2-374 




:SET-TERM 

79,24,,,,8, 132,55,YJ 

:SET-TERM 

YJ 


On SYSPROG or SECURITY account. 


LOAD-TERM DEF 
TERM 
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SET-TIME 


Syntax 


Description 


Available On 


See Also 


SET-TIME changes the system time. System time is based on the 24- 
hour clock. 


SET-TIME hh{:mm{:ss}} 

hh Specifies hours (00-23); a leading zero is not required. 

mm Specifies minutes (00-59); a leading zero is not required. 

If omitted, 00 is assumed. 

s s Specifies seconds (00-59); a leading zero is not required. 

If omitted, 00 is assumed. 

Note: A colon is required between parameters. 


Use SET-TIME to change the system time. Hours are entered and 
displayed in 24-hour format, where midnight is 00:00:00, 1 a.m. is 
01:00:00, noon is 12:00:00, and 1 p.m. is 13:00:00. 

The system updates the date at midnight (00:00:00). 


: SET-TIME 

13 J 

Set time to 1 p.m. 

13:00:00 22 

JUN 1991 


:SET-TIME 

10:45J 

Set time to 10:45 a.m. 

10:45:00 22 

JUN 1991 



SYSPROG or SECURITY account. This command is not available on 
Ultimate S/370 and S/390 systems in VM/VMS mode. 


DATE 

SET-DATE 

TIME 
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SHOW-LEVELS 

SHOW-LEVELS displays information on TCL levels activated by the 
specified line. 


,«r> 


Syntax show-levels {n} 

n Specifies the line for which TCL level information should 

be shown. If omitted, the current line is assumed. 


Description Use SHOW-LEVELS to display all TCL levels activated by the specified 
line. The following information is displayed for the specified line: 

Level Type Processor {Filename Item-id} 

where: 


Level Zero (0) is logon (base) level. The maximum number of 
TCL levels depends on available disk space. 

Type Type of activity that caused the level to be activated: 


base 

TCL logon level. 

exec 

BASIC execute. 

wp 

Word processor (UltiWord). 

push 

Level push. 

!> 

System debugger (one system command is 
executed, the level is exited, and control 
returns to the debugger). 

!» 

Next TCL level is entered from the debugger. 

Processor Active processor for the level. Processors include 
BASIC, PROC, RECALL, TCL, WP. 

Filename Name of the BASIC file being executed, or indicates WP 
document exists. 


Item-id Name of the BASIC item-ID being executed, or WP item- 
ID. 


c 
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Available 

See Also 

6985 - 3.2 


Note : Filename and item-lD are only displayed if line is omitted, or if 

the command is executed from SYSPROG or SECURITY 
accounts. 

If only the base level is active, the following message is displayed: 

[668] No other TCL levels active. 


: SHOW- 

LEVELS 

33 J 

Show TCL levels for line 33 (not the 




current line). Notice that filenames and 




item-IDs are not displayed. 

SHOW-LEVELS for 

Line: 

033 at hh:mm:ss dd mmm yyyy 

Level 

Type 

Processor 

3 

push 

current level 

2 

push 

TCL 


1 

exec 

WP 


0 ' 

base 

BASIC 

Run-time 

:LOGTO 

SYSPROGJ 


:SHOW- 

LEVELS 

33 J 


SHOW-LEVELS for 

Line: 

033 at hh:mm:ss dd mmm yyyy 

Level 

Type 

Processor Filename Itemid 

3 

push 

current level 

2 

push 

TCL 


1 

exec 

WP 

[WP-DOCUMENTS, ULT MEMO] 

0 

base 

BASIC 

Run-time [WP-PROGS WP 


On Any user account. 


LEVEL-EXIT 

SET-LEVEL-PUSH 

Chapter 1 of this document for further information on TCL level 
pushing. 
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SLEEP 

SLEEP deactivates a terminal and stops processing for a specified period 
of time. 

Syntax sleep n 

SLEEP hh:mm:{ss} 

n Specifies the number of seconds to sleep. 

hh:mm:ss Specifies the time (based on 24-hour clock) at which the 
terminal should wake up. 


Description Use SLEEP to stop processing on a terminal for a specified number of 

seconds, or until a specified wake-up time. 

As soon as SLEEP is invoked, the terminal is deactivated. When the 
SLEEP period ends or the wake-up time is reached, the terminal is 
reactivated and any queued commands are executed. 

SLEEP can be canceled with the <BREAK> and END sequence, which 
ignores any previous keyboard input. You can also use the MSG or 
MESSAGE command from another terminal to wake up a sleeping terminal. 

You can use the wake-up feature of SLEEP to control when the system 
will run a task on your terminal. For example, you can put SLEEP in a 
file-save PROG to preset an exact run-time, such as setting a file-save to 
run at 23:00 (11 :()() p.m.) every night. 


: sleep 100J Set the terminal to sleep for 100 seconds. 

: sleep 22 : 00 J Set the terminal to sleep until 22:00 (10 p.m.) 


Available On Any user account. 


See Also message 

MSG 
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SORT 

SORT is an Ultimate RECALL command that rearranges selected file 
items into a specified sequence and then generates formatted output of 
the selected attribute data. 

Syntax SORT filename {itemlist} {sel-criteria} {sort-criteria} 

{output-specifications {print-limiters}} {(options} 

filename Specifies the file containing the items to be sorted. 

itemlist Specifies one or more explicit item-IDs. If specified, 

each item-ID must be enclosed in single quotes, 
double quotes, or backslashes. If omitted, the 
command acts on the current select-list, or on all 
items in the file if no select-list is present. 

sel-criteria Specifies conditions that must be met by an item in 
order for it to be selected. Also known as a WITH 
clause. 

sort-criteria Specifies sorting sequence. Also known as a BY 
clause. 

output- Specifies the attributes and values in the selected 

specifications items that should be listed. 

print-limiters Restricts the printing of output specification to values 
that meet the limit conditions. 

(options 

C Suppresses column heading lines that define 

attributes in a report. 

D Suppresses all detail lines from a report. 

H Suppresses the report's page heading line and "n 

items listed" line. 

I Suppresses the item-ID column or row heading. 
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N 


Specifies no automatic end-of-page waiting. 
Routes output to the spooler. 


Description 


Available On 


For further information on SORT, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 

Any user account. 
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SORT-ITEM 


Syntax 


Description 


Available On 


6985-3.2 


SORT-ITEM is an Ultimate RECALL command that sorts selected items, 
then lists them in Line Editor format. 


SORT-ITEM filename {itemlist} {sel-criteria} {sort-criteria} 
{(options} 

filename Specifies the file for which items should be sorted and 
listed. 


itemlist Specifies one or more explicit item-IDs. If specified, 
each item-lD must be enclosed in single quotes, double 
quotes, or backslashes. If omitted, the command acts on 
the current select-list, or on all items in the file if no 
select-list is present. 

sel-criteria Specifies conditions that must be met by an item in order 
for it to be sorted and listed. Also known as a WITH 
clause. 


sort-criteria Specifies sorting sequence. Also known as a BY clause. 


(options 

A 

F 

N 

P 

S 


Lists items in editor assembler format. 
Formfeeds after each item. 

Specifies no automatic end-of-page waiting. 
Routes output to the spooler. 

Suppresses line numbers. 


For further information on SORT-ITEM, please refer to the Ultimate 
RECALL and Ultimate UPDATE User Guide. 


Any user account. 
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SORT-LABEL 

SORT-LABEL is an Ultimate RECALL command that generates sorted and 
formatted output of data from items in a file. Item data can be grouped 
into blocks, with several blocks placed across the page, as in a set of 
mailing labels. SORT-LABEL is similar to SORT, except that more than 
one item can exist on an output line. 

Syntax SORT-LABEL filename {itemlist} {sel-criteria} {output- 

specifications {print-limiters}} {(options} 

filename Specifies the file for which labels should be sorted 

and listed. 

itemlist Specifies one or more explicit item-lDs. If specified, 

each item-lD must be enclosed in single quotes, 
double quotes, or backslashes. If omitted, the 
command acts on the current select-list, or on all 
items in the file if no select-list is present. 

sel-criteria Conditions that must be met by an item in order for it 
to be sorted and listed. Also known as a WITH 
clause. 

output- Specifies the attributes and values in the selected 

specifications items that should be listed. 

print-limiters Restricts the printing of output specification to values 
that meet the limit conditions. 

(options 

C Suppresses column heading lines that define 

attributes in a report. 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 

Description For further information on SORT-LABEL, please refer to the Ultimate 
RECALL and Ultimate UPDATE User Guide. 

Available On Any user account. 
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SP-ASSIGN 


SP-ASSIGN displays or changes the terminal's current spooler 
assignment. 


Syntax 


SP-ASSIGN {?} {output options} {Qn} {copy} {Rn} 


Displays the current spooler assignment if other 
parameters are omitted. If other parameters are specified, 
displays the new settings. 


output Specifies whether the job should be routed or held. 


options 

C 


H 

I 


O 


P 


More than one may be specified. 

Chokes a print job by limiting it to 20 frames of disk 
space at a time. As a job is printed, frames associated 
with the job are released back to the pool of available 
space. Only valid with the 1 option below. 

Retains the print job as a hold file. 

Immediately enqueues a print job as it is processing. 

The default is for a job to be enqueued when the entire 
job has been processed. 

Keeps the print job open after completion until closed by 
SP-CLOSE or another SP-ASSIGN. This is the same as the 
SP-OPEN command, and is useful for combining several 
reports that are one logical job but must be generated as 
separate units, such as by multiple execution of 
commands or BASIC programs. 

Routes output to the specified queue. 


S Suppresses (does not queue) the print job. Can be used 

with H to create a hold file that is not output at this time, 
or with T to send output only to tape. 

T Routes output to tape; assumes that a tape drive is 

available. The tape must be attached. 


Note: The tape file does not have the same format as tapes 

produced by FILE-SAVE or T-DUMP. 
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Description 


Qn Specifies the number (from 0-253) of the job queue for 

the print job. The default is job queue 0 (Q0). 

copy Specifies the number of copies (from 0-125) to be output 

to the printer device. The default is one copy. When 
output is to tape only, one copy is sent. If output is to 
tape and a printer, one copy is sent to tape and the 
specified number of copies are printed. 

Note: If IC is present, only one copy is printed. 


Rn Specifies the number (from 0-255) of a print file that 

corresponds to a PRINT ON n statement in BASIC, a 
•PFILE n in RUNOFF, or a \PFILE n in UltiWord. 


Note: If parameters are omitted, the following default values are 

reset: 


• Print jobs are enqueued in job queue 0 (zero) at the 
completion of processing. 

• One copy is output. 


Use SP-ASSIGN to display or change spooler assignments. SP-ASSIGN 
can also be used to select spooler assignments for a specific print file 
number, which is useful when compiling reports or documents that have 
unique print requirements. 

Although SP-ASSIGN accepts any combination of parameters, some are 
conflicting. In these cases, one has priority and will be implemented by 
the command; the others are ignored. The conflicts and priorities are: 

S(uppress queueing) Overrides P, Qn, and copy. 

H(old file) Overrides C. 

IC(immediately enqueue, Overrides copy and sets copies to 1. 
choke) 

If output options are omitted, the print job is queued to the job queue 
specified by Qn, with no hold file and no tape output. 
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If I or IC is present, the spooler starts to enqueue the print job as soon as 
the first line of data is available, rather than waiting for the entire job to 
be processed before queueing it. 

The C option allows a maximum of 20 frames of disk space to be used 
to store the print job, and it causes frames to be released to available 
space as they are printed. This means that if output generation is 20 
frames ahead of printing by the physical printer device, the process 
suspends generation of output until a sufficient number of frames are 
printed and released to available space. If the C option is not in effect, 
data frames are released to available space only after the printer has 
finished printing the job. 

Normally when a print job has completed, it is closed and the output 
generation process cannot add any more data to it. The O option keeps 
the print job open until it is explicitly closed by SP-CLOSE or by another 
SP-ASSIGN. 

If SP-ASSIGN is executed from a BASIC program, and either a PRINTER 
ON statement or an SP-ASSIGN O was in effect prior to executing the 
BASIC program, the following message is displayed: 

[1140] Your open files were closed 

Any open print files are closed and the new spooler assignments affect 
subsequent printing during the operation of the BASIC program. 

The spooler assignment is normally used for all print jobs on a line. 
However, if the Rn parameter is specified, SP-ASSIGN parameters are 
only assigned to the specified print file number. It does not change the 
current spooler assignment or the options used with any other BASIC, 
RUNOFF, or UltiWord print files. This option is used with the 
following BASIC and word processing statements that allow printing of 
selected material in selected print files to create a single printout: 

PRINT ON n (BASIC) 

.PFILE n (RUNOFF) 

XPFILE n (UltiWord) 

Only data produced by statements specifying print file n are sent to the 
reserved print job. Usually the print job is closed when the BASIC 
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Available 

See Also 


2-386 


. I f~\ 

$ 

program, RUNOFF item, or UltiWord item is terminated, although you 
can use the O option to force the job to remain open. 

Print jobs are printed in their job queue order. Note that although the 
output options queue the print job as soon as possible, they do not 
guarantee immediate printing unless the job is first job in the queue and 
the printer is attached. 


:SP-ASSIGN 

?J 


View the current spooler assignments. 

Line Status 

Cop 

Form 

Assignment for line 2 is to output 1 copy 

# 

ies 

# 

from job queue (form) 0 to the printer (P) 

2 P 

1 

0 

These are the default settings. 

:SP-ASSIGN 

ICO 

Q4J 

Immediately enqueue and choke to 20 
frames, leave queue open, and print 1 
copy from job queue 4. 

:SP-ASSIGN 

? J 


Show new settings. 

Line Status 

Cop 

Form 


# 

ies 

# 


2 PIC 0 

1 

4 


:SP-ASSIGN J 


Return to default settings. 


On Any user account. 


SP-CLOSE 

SP-MENU 

SP-OPEN 

T-ATT 

Guide to the Ultimate Editors. 

Ultimate BASIC Language Reference Guide. 
UltiWord Reference Guide. 



Ultimate System Commands Guide 6985-3.2 

Confidential and Proprietary to The Ultimate Corp. 





SP-CLOSE 


SP-CLOSE 

Syntax 

Description 

Available On 

See Also 


SP-CLOSE closes all open print jobs for the current line. 


SP-CLOSE 


Normally, when a print job is created by a command, a BASIC program, 
or the word processor, the print job is automatically closed at the end of 
the execution. However, commands such as SP-OPEN and SP-ASSIGN O 
direct the spooler to keep the print job open in order to combine multiple 
files that are logically one print unit. SP-CLOSE closes these print jobs. 

Note: At logoff (OFF or LOGOFF) all print jobs are closed 

automatically. 


Any user account. 


SP-ASSIGN 

SP-OPEN 
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SP-DELETELPTR 

SP-DELETELPTR deletes a logical printer from the system. 

Syntax sp-deletelptr n {o} 

n Specifies the number of the logical printer to be deleted. 

O Unconditionally deletes the printer even if there is an 

active job assigned to it. The job that is being printed is 
deleted; any jobs waiting to be printed remain in the 
queue, just as if the printer had never been started. 

Description Unless the O option is used, SP-DELETELPTR assumes that the printer 

has been stopped with SP-STOPLPTR and is inactive, and that no print 
jobs are pending. SP-DELETELPTR detaches the job queues currently 
attached to the specified printer, and the system can no longer access the 
physical printer device currently associated with that logical printer 
number. 



Available On sysprog or security account. 


See Also sp-menu 

SP-STARTLPTR 

SP-STOPLPTR 
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SP-DEQ 


Syntax 


Description 


Available On 


See Also 


6985 - 3.2 


SP-DEQ dequeues a print job waiting in a job queue. 


SP-DEQ n {U} 

n Specifies the entry number of the print job to be 

dequeued. Must be a job that was queued by the current 
line, unless the U parameter below is used. 

U Specifies unconditional access to the specified print job 

to be dequeued. You must have privilege level 2 to use 
this parameter. 


Use SP-DEQ to dequeue a waiting print job. 

Note: If the print job lias started printing, use SP-KILL. 

SP-DEQ dequeues the specified print job entry number in the job queue 
by removing it from the queue. The print job is retained as a hold file, 
and is therefore available to SP-EDlTfor subsequent re-spooling or 
deleting. 


: sp-deq 12 J Dequeue print job number 12. 


Any user account to dequeue your own print job. You must have 
privilege level 2 to dequeue another print job. 


SP-KILL 

SP-LISTQ 

SP-MENU 
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SP-EDIT 


Syntax 


Description 


2-390 



SP-EDIT allows you to display, spool, or delete specified hold files. 


SP-EDIT {options} 


options 

'accountname' Specifies edit of hold files generated by this 

account. (You must have privilege level 2 to edit 
hold files in another account.) This overrides the 
U option. 

n {- m } Specifies entry number or range of numbers of 

the hold file to be displayed, printed, or deleted. 
If omitted, all hold files created by the current 
account are assumed. 


Note: To determine the entry number of a print job, 

note the hold file number when the job is created, 
or use SP-LISTQ. 


Fn{-m} 

L 

MD 

MS 


T 


Specifies form number or range of numbers of 
the hold file to be displayed, printed, or deleted. 

Displays an enqueued print file. 

Deletes multiple hold files. No further prompts 
are displayed. 

Spools multiple hold files using the current SP- 
ASSIGN parameters No further prompts are 
displayed. 

Directs the hold file to tape. 


U Allows SP-EDIT to operate on queue entries 

created by accounts other than your own. You 
must have privilege level 2 to use this parameter. 




Use SP-EDIT to display, spool, or delete one or more hold files created 
by the current or specified account. Users with privilege level 2 can 
access any hold file in the system. 
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Display the 
Hold File 


6985 - 3.2 


A hold file can only be accessed by one user at a time. If the hold file is 
currently being accessed by SP-EDIT or is being spooled by another 
user, the following message is displayed: 

Not Available 

Note: Prior to using SP-EDIT to process a hold file, use SP-ASSIGN to 

set up the necessary spooler assignments for outputting the 
hold file data. The output destination must be printer (P 
option), tape (T option), or both. The SP-ASSIGN options 
should not be used. The II option, if present, is ignored. 

SP-EDIT accesses the specified hold files. If no file is found, the 
following message is displayed: 

[1162] End of print file control block 

When a hold file is found, the command displays a series of prompts 
that allow you to specify the following: 

• Display the first frame of the hold file. 

• Search for a specified string. 

• Spool the hold file. 

• Delete the hold file. 

Each of these options is described below. 

The DISPLAY prompt allows you to view the first frame of the hold file, 
go to another prompt, or exit the command. The DISPLAY prompt is 
displayed as: 

DISPLAY? (Y/N/S/D/X/<CR>) ? 

where: 

Y Display the first frame of the hold file. 

N Go to the next prompt (STRING-). 

S Go to the SPOOL prompt. 

D Go to the DELETE prompt. 

X Exit SP-EDIT. 

< C R > Go to the next hold file. 
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SP-EDIT 


Search for a 
String 


Spool the 
Hold File 


Any other response skips to the STRING- prompt. 

The STRING- prompt allows you to enter a search string to find in the 
hold file. The STRING- prompt is displayed as: 

STRING- 

The STRING- prompt options are: 

"text" Text string to search for in the hold file. Start spooling 
file from "text" to end of file. (Spooling does not start 
until after an entry is made at the SPOOL prompt below.) 

<CR> Go to the SPOOL prompt. 

The SPOOL prompt requests the output destination for a hold file to be 
spooled as a print job or to the terminal, or a file with RUNOFF format 
items. The SPOOL prompt is displayed as: 

SPOOL (Y/N=<CR>/T/TN/F) ? 

where: 

Y Spools the hold file as a print job with current SP-ASSIGN 

parameters; if the destination does not contain P or T, an 
error message is displayed. 

N or <CR> Goes to next prompt (DELETE). 

T Spools the hold file to your terminal, one screen page at 

a time. The spooler waits for input at the end of each 
screen. Enter: 

<CR> Displays next screen page. 

U Repeats the current page on screen. 

T Stans again from the beginning of the hold file. 

X Ends screen display of the hold file. 

When screen display ends, the SPOOL prompt is re¬ 
displayed. 

TN Spools the hold file to your terminal without end-of-page 

waiting, until the end of the file is reached, then returns 
to the SPOOL prompt. 
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SP-EDIT 


Delete the 
Hold File 


Spooling to a 
File 


F Converts the hold file to Ultimate items in RUNOFF 

format. (See the subsection. Spooling to a File.) The 
user must be logged onto the account that created the 
hold file, or use the U option. 

Any other response skips to the DELETE prompt. 

The DELETE prompt lets you delete the current hold file or go to the next 
print job. The DELETE prompt is displayed as: 

DELETE (Y/N=<CR>)? 

where: 

Y Delete the hold file from the system. The disk space is 

released to available space. 

Nor <CR> Go to the next print job. 

Any other response skips to the next print job. 

When the spooler transfers a hold file to file items, it prompts for a 
destination filename and starting item-lD as follows: 

File name?- 

Initial item name?- 

If the item-lD already exists in the specified file, the existing item is 
overwritten by the hold file data. 

When it transfers the hold file, the spooler first places the RUNOFF 
commands .BP and .NF at the top of the item. It then copies the contents 
of the first page of the hold file into the item. 

Hold files that are not paginated or that have very long pages (more than 
1200 data bytes) are blocked into multiple items, each with a maximum 
of 1200 data bytes. For multi-page hold files, each hold file page 
becomes an item. A sequential number is appended to the starting item- 
ID. The following RUNOFF command is appended to the end of each 
item; except the last: 

.CHAIN item-IDnnn 
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Available On 


See Also 


2-394 


where n starts at (X)01 and is incremented for each item. 

You must wait until the SP-EDIT or spooling is completed before the 
hold file can be accessed. 

: SP-EDIT 4J 
:SP-EDIT 3 UJ 


Any user account to edit your own print jobs. You must have privilege 
level 2 to edit print jobs from another account. 


SP-ASSIGN 

SP-DEQ 

SP-MENU 
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SP-KILL 


Syntax 


Description 


Available On 


See Also 


6985 - 3.2 


SP-KILL aborts a print job currently being printed on a physical printer 
device. 


SP-KILL n {U} 

n Specifies the number of the logical printer where the 

print job is to be killed. Must be a job that was created 
by the current account, unless the U parameter below is 
used. 

U Unconditionally kills the job on the specified printer. 


Use SP-KILL to kill a job that is currently printing. 

Note: If the print job lias not started printing, use SP-DEQ. 

SP-KILL accesses the specified logical printer and aborts the print job 
currently being output, as soon as all characters already in the buffer are 
printed. The message ABORT! is printed on the output, and the next job 
in the job queue is sent to the physical printer device for printing. 

A killed print job is retained as a hold file only if the H option was 
previously set via SP-ASS1GN. 


: SP-KILL 2J 

Kill the print job currently 


printing on logical printer 2. 


Any user account to kill your own print jobs. You must have privilege 
level 2 to kill another print job. 


SP-ASSIGN 

SP-DEQ 
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SP-LISTASSIGN 

SP-LISTASSIGN lists the current spooler assignments of all lines on the 
system. 


Syntax sp-listassign 


Description Use SP-LISTASSIGN to display the current spooler assignments for all 
lines, in the following format: 

Line Status Cop Form 

# ies # 

where: 

Line # Identifies the line. 

Status Identifies output specifications for print jobs queued by 
the line. Output specifications are: 

C Choke print job processing to 20 frames at a time. 

H Send output to hold file. 

I Enqueue as job becomes available. 

O Keep print job open at end of process. 

P Print output. If P is omitted, printing is suppressed. 

T Send output to tape. 

Copies Identifies the number of copies to be output. 

Form # Identifies the job queue number. 

Spooler assignments for each line are made via SP-ASS1GN. 
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Available 

See Also 
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SP-LISTASSIGNJ 


Display spooler assignments for 
all lines on the system. 

Line Status Cop Form 


# 

ies 

# 


0 P 

1 

5 


1 PI 

1 

0 


2 P 

4 

0 


3 PIC 

1 

0 


4 PI 

1 

0 


5 PO 

1 

0 


6 HT 

1 

0 


7 H 

1 

0 


8 

0 

0 

This line has never logged on or 
has not reset option after 

SP-ST ARTLPTR. 


On SYSPROG or SECURITY account. 


SP-ASSIGN 
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SP-LISTLPTR 

SP-LISTLPTR displays the status of each logical printer on the system. 

Syntax sp-listlptr 


Description Use SP-LISTLPTR to display the status of all printers on the system in 

logical printer number order in the following format: 

Printer assignments hh:mm:ss 

Printer Output queues Page Dev or Status 

Type Number skip line # 


where: 

Printer Type 
Number 
Output Queues 

Page Skip 
Dev or line# 

Status 


Parallel or Serial. 

Logical printer number. 

Identifies job queue numbers attached to the 
logical printer. Also known as Form#. 

Number of pages to skip between print jobs. 

Parallel printer device number or serial printer 
line number. 

One of the following: 

Stopped Printer has been stopped by SP- 
STOPLPTR. 

Active A job is currently printing on the 
physical printer device. 

Inactive The printer device is not printing. 
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Available 

See Also 


6985 - 3.2 


:SP-LISTLPTRJ 





Printer assignments 

hh:mm:ss 


Printer 

Output 

queues Page 

Dev or 

Status 

Type Number 


skip 

line # 


Parallel 0 

1 

0 

0 

Inactive 

Serial 1 

0 

4 

59 

Inactive 


On Any user account. 


SP-STATUS 
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SP-LISTQ 


Syntax 


Description 


SP-LISTQ lists the status of print jobs in all job queues. 

SP-LISTQ {n} {account} {options} 

n Specifies the entry number of a print job for which status 

is to be displayed. 

Limits display to print jobs created by the specified 
account. 

Limits list to print jobs created by the current account. 

Suppresses listing of status information. Only the total 
number of print jobs and their total amount of disk space 
used are displayed. 

Replaces status information with current position and 
beginning frame ID (FID) of hold file. 

Displays jobs that have already been printed and purged. 

Routes output to the spooler. 

Outputs a list of jobs queued for printing in groups by 
job queue (Form#) number order. 

Note: If parameters are omitted, all print jobs are displayed. 

Use SP-LISTQ to display print job entry numbers and other print job 
status. If parameters are omitted, the listing is displayed in the 
following format: 

[1131] Printer li$,t elements dd MON yyyy hh:mm:ss 

# Stat Lk Ln Status Cp Fo Frms Date Time Acct 

where: 

# Print job entry number. 

Stat Status word in hexadecimal; for maintenance use only. 

Lk Forward link, if other than zero; indicates next job to be 

printed. 


account 

A 

C 

E 

L 

P 

Q 
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Ln Line number that generated the job, or line on which this 

hold file is being edited with SP-EDIT. 

Status Print job status indicators: 

A Available entry (displayed only if L option used) 

C Closed 
G Align 
H Hold file 
I Immediate 
L Locked 
N No close 

O Currently being output 
P Printer 

R Requeued (SP-EDIT) 

S Spooled 
T Tape 

X Killed (SP-KILL) 

Cp Number of copies. 

Fo Job queue number (Form# on SP-ASSIGN listing). 

Frms Number of frames, if closed, or OPEN, if open job. 

Date System date job was created. 

Time System time job was created. 

Acct Account name under which job was created. 

If the E option is used, the print job entry number and status information 
are omitted and the columns Curpos and Begfid are displayed: 

• Curpos displays the 12-digit hexadecimal current position. 

• Begfid displays the hexadecimal starting frame of the print job. 
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:SP-listqj List all print jobs. 

[1131] Printer list elements dd MON yyyy hh:mm:ss 


# 

Stat 

Lk Ln Status 

Cp Fo Frms Date 

Time Acct 


1 

0080 

9 HP C 

1 4 261 

01/31/85 

17:49:32 TSB 


2 

0080 

1 HP C 

1 4 575 

02/06/85 

15:58:54 TSB 


3 

8100 

5 H C 

1 0 37 

02/06/85 

10:37:52 DOCU 


4 

0088 

0 HP C R 

10 81 

02/01/85 

12:51:38 BUG 


5 

8080 

5 H C 

3 0 4 

02/02/85 

12:53:01 DP 


6 

41C1 

5 P L 

1 0 OPEN 

02/03/85 

12:40:37 DOCU 


9 

C098 

5 HP C XR 

5 121 

01/31/85 

12:06:56 DP 


10 

80C1 

1 H L 

3 0 OPEN 

02/01/85 

09 : 45:42 DP 


8 queue elements. 1034 frames 

: SP-LISTQ EJ 

[1131] Printer list elements 

in use. 

List all print jobs and show current 
position and starting FID. 

dd MON yyyy hh:mm:ss 


Stat 

Lk Ln 

Curpos 

Begfid 

Cp Fo Frms 

Date Time 

Acct 

8880 

50 

00010010EA13 

0010EA13 

1 4 261 

01/31/85 17:49:32 

TSB 

CO 8 8 

42 

00010006B9DF 

0006B9DF 

10 40 

01/31/85 17:53:22 

ALF 

CO 88 

42 

0001000EF32C 

000EF32C 

10 40 

01/31/85 17:59:14 

ALF 


df" ^ 

O 


V V 


Available On Any user account. 


See Also 


SP-ASSIGN 

SP-MENU 

SP-ED1T 
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SP-MENU 

Syntax 

Description 


Available On 
See Also 


6985 - 3.2 


SP-MENU provides a menu for selecting common spooler operations 
such as starting and stopping printers, editing hold file entries, and 
displaying the status of printers and print jobs. 


SP-MENU 


SP-MENU displays the following menu of spooler command options: 


The Ultimate Spooler Menu ’ 

time date 

1. Start a line printer 

2. Stop a line printer 

3. Delete a line printer 

4 . Set the output print assignments for your line 

5. List the print jobs in the job queue 

6. Process a Hold File in the job queue 

7. Dequeue a job in the job queue 

8. List status of the spooler and each line printer 

9. List the assignments and status of every printer 

Please enter the option of your choice or TCL or OFF - 

V._ J 


Enter an option number to begin execution of the spooler command. If 
the command has associated parameters, SP-MENU prompts for them. 

SYSPROG or SECURITY account. 

SP-ASSIGN 

SP-DELETELPTR 

SP-DEQ 

SP-EDIT 

SP-LISTLPTR 

SP-LISTQ 

SP-STARTLPTR 

SP-STATUS 

SP-STOPLPTR 
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SP-OPEN 

Syntax 

Description 


Available On 

See Also 

2-404 


SP-OPEN forces print jobs created by a subsequent command or BASIC 
program to remain open even after the command or program is 
completed. 


SP-OPEN 


SP-OPEN is an alternative to using SP-ASSIGN with the O option. Use it 
when you want to compile a print job that contains output from several 
programs or processes. This command is useful for printing an index, a 
manual, or other long document that has multiple parts. 

Note: SP-OPEN does not open a print job. It merely specifies that a 

print job shall not be closed when the program or command 
that creates the print job has completed execution. 

Use SP-OPEN after setting any necessary SP-ASSIGN spooler assignments, 
but before executing the first command or program that creates the print 
job or jobs. SP-OPEN directs the spooler to keep the print job open until it 
is explicitly or implicitly closed. 

Open print jobs can be closed by using one of the following: 

♦ SP-CLOSE to explicitly close open print jobs. 

♦ SP-ASSIGN without the O option to implicitly close all open print 
jobs. Also, if SP-ASSIGN is executed with the BASIC statement 
PRINTER ON in effect, the file is closed. 

♦ OFF, LOGOFF, or LOGTO to automatically close all print jobs. 


: SP-OPENJ 

Leave the next print job open until it is 

• 

explicitly or implicitly closed. 


Any user account. 


SP-ASSIGN 

SP-CLOSE 
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SP-SKIP 

Syntax 

Description 


Available On 

See Also 


SP-SKIP sets the number of pages to skip between print jobs. 


SP-SKIP lp{,n} 

Ip Specifies the logical printer on which pages should be 

skipped. 

,n Specifies the number of pages (from 0-9) to skip 

between print jobs. If omitted, no pages are skipped. 


Use SP-SKIP to specify the number of pages to skip between print jobs. 
The specified logical printer must have been previously started by SP- 
STARTLPTR. 

You can review the current SP-SKIP setting for any or all logical printers 
via the SP-LISTLPTR or SP-STATUS commands. 


The SP-SKIP setting remains in effect until reset by another SP-SKIP 
command. 


:SP-SKIP 5,1J 

Skip 1 page between print jobs on 


logical printer 5. 


SYSPROG or SECURITY account. 


SP-LISTLPTR 

SP-STATUS 

SP-STARTLPTR 
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SP-STARTLPTR 

SP-STARTLPTR assigns a physical printer device to a logical printer, and 
assigns a job queue number and number of pages to skip between print 
jobs to that logical printer. It can also be used to restart a logical printer 
or to control forms alignment. On Ultimate S/370 and S/390 systems, 
two additional parameters are available to load the Universal Character 
Set Buffer (UCSB) and a Forms Control Buffer (FCB). 


Positional sp-startlptr ip,q,{ej},{pn/sn},{A} 

Syntax or 

SP-STARTLPTR lp,(ql,q2{,q3}),{ej},{Pn/Sn},{ A } 


Keyword 

Syntax 


SP-STARTLPTR PRINTER = Ip 

QUEUE = q / QUEUE = (ql,q2{,q3» 
{EJECT = ej) 

{PARALLEL = n} / {SERIAL = n} 
{ALIGN} 

{UCSB = ucsb-item-iD} 

{FCB = fcb-item-iD} 


SP-STARTLPTR positional parameters and keywords are described 
below: 

Parameter Keyword Description 


ip 


PRINTER = Required. Specifies the logical 
I p printer to be started. The range of 

available printers depends on your 
system. 


q QUEUE = q Required except when restarting a 

printer. Specifies a single job queue 
number (0-125) from which print 
jobs are sent to the logical printer. 


(ql,q2{,q3}) QUEUE =(ql, Associates two or three job queues 
q 2 {, q 3 }) with the logical printer. Enclose the 

queue numbers in parentheses, and 
separate them with commas. 
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Parameter 

ej 


Pn 


Sn 


A 


Keyword Description 

EJECT =ej Specifies the number (from 0-9) of 
pages to skip (eject) between print 
jobs. If omitted, no pages are 
skipped. 

PARALLEL = Specifies a parallel printer device. 

° Enter a number from 0-15. Enter 0 

to assign the parallel printer 
connected to the lowest system 
channel, or if the system has only 
one parallel printer. Enter 1 to 
assign the parallel printer connected 
to the next higher channel, and so 
on. 


For positional format, you must 
specify P before the number, as in 
P0. 

SERIAL = n Specifies a serial printer device. 

Enter the terminal line number to 
which the serial printer is 
connected. 

For positional format, you must 
specify S before the number, as in 
S35. 

ALIGN Specifies manual forms alignment. 

Applies only when one queue is 
specified for the printer. The printer 
must first be stopped via 
SP-STOPLPTR. 
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Description 


Parameter 


Keyword Description 

UCSB = Applies only to Ultimate S/370 and 
ucsb- S/390 systems with parallel printers, 

item-ID and must be specified before using the 

parallel printer. This parameter is an 
item-ID in the UCSB-DEF file on the 
SYSPROG account. The item defines the 
print chain, and provides an ASCII-to- 
EBCDIC translation mapping of ASCH-to 
EBCDIC values for this printer. Please 
refer to Appendix D for the format of 
the UCSB-DEF item. 


FCB = Applies only to Ultimate S/370 and 
fcb-item- S/390 systems with parallel printers that 
ID accept a forms control buffer (FCB). 

This parameter is an item-ID in the FC'B- 
DEF file on the SYSPROG account. This 
item defines the following printer 
characteristics: 


• lines per inch 

• print density 

• index value 

• first printable line 

• number of lines per page 

Please refer to Appendix D for the 
format of the FCB-DEF item. 







SP-STARTLPTR sets up and maintains parameters for the logical printers 
in your system. For each logical printer, the spooler maintains 
parameters for the following: 

• The physical printer device attached to it. 

• The job queue(s) attached to it. 

• The number of pages to skip (eject) between print jobs. 

SP-STARTLPTR can be used to set or change any of these parameters, or 
to restart a printer that has been stopped by SP-STOPLPTR..It can also be 
used to align the form (paper) on a physical printer device. To do this, 
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Starting an 
On-line 
Physical 
Printer 


Changing 
Job Queue 
Attachments 


Restarting a 
Stopped 
Logical 
Printer 


Aligning 
Forms on a 
Physical 
Printer 
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the logical printer must have been stopped by SP-STOPLPTR and must be 
currently inactive (not printing any job). 

To start an on-line printer, specify the lp, q or (ql,q2 {,q3}), ej, and 
Pn/Sn parameters or equivalent keywords. The command assigns the 
logical printer lp to the physical printer device Pn/Sn (or n if keyword 
format is used). The specified job queue(s) are attached to the logical 
printer, and the number of page ejects between jobs is set to ej. These 
parameters are displayed as Printer Type, Number, Output Queues, 

Page skip, and Dev or line #. 

One job queue can be used for a single or shared job queue attachment. 
Two or three job queues indicate a multiple job queue attachment. In 
multiple attachments, ql has the highest priority, q2 has a lower 
priority, and q3, if specified, has the lowest priority. 

At least one job queue must be explicitly specified, even if it is the 
default (job queue 0). 

To change job queue attachments for a printer, specify the lp and q or 
(ql,q2 {,q3}) parameters, or their associated keywords. SP- 
STARTLPTR automatically detaches all job queues currently attached to 
the printer, then attaches the specified new job queues. The physical 
printer device type and page eject number are not changed. 

To restart a stopped printer, specify the lp parameter only. The logical 
printer is assumed to have been previously stopped by SP-STOPLPTR. 
SP-STARTLPTR restarts the specified printer without changing any 
parameters. The logical printer resumes printing by sending the first job 
waiting in the job queue, or first job in each job queue, to the physical 
printer device. 

To align forms, the printer must first be stopped with SP-STOPLPTR. 
Once the printer has been stopped, specify the lp, q, and A parameters 
or their associated keywords. Any other setting can also be changed. If 
the printer has been stopped via SP-STOPLPTR, SP-STARTLPTR detaches 
all job queues currently attached to the printer, and the printer enters 
alignment mode. 

If the printer has not been stopped via SP-STOPLPTR or is still printing a 
job, the following error message is displayed: 
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[1105] Printer must be stopped. 

When the alignment mode is successfully entered, the following prompt 
is displayed: 

Lines? 

Enter the number of lines to be printed on the form in order to check the 
alignment. For example, enter 10 to print the first 10 lines of your print 
job to see if the alignment is correct, After printing the specified number 
of lines, the following prompt is displayed: 

Again (Y/N/T)? 

To print the same number of lines again, enter Y. 

To exit the alignment mode and resume normal printer operation, enter 
N. The jobs in the specified job queue then begin printing on the 
physical printer device. 

To exit the alignment mode without resuming normal printer operation, 
enter T. The physical printer remains stopped (no queued print jobs are 
printed), although the new parameters are now in effect. 


J All parallel printers connected to an Ultimate S/370 or S/390 system 

an must have a Universal Character Set Buffer (UCSB) loaded before the 

printer is used. If specifying the alignment (ALIGN or A ) parameter, the 
UCSB must be loaded either previously or at the same time. 

Whenever the print train is changed on a printer, execute a new SP- 
STARTLPTR and specify the appropriate UCSB item. This step ensures 
that the internal character positions on the print train are properly loaded. 
If the correct UCSB is not loaded, then random characters or blank lines 
will be printed. 

Both UCSB and FCB parameters should only be used when the printer is 
stopped and inactive. Specify the ucsb-item-ID parameter, which is then 
loaded by SP-STARTLPTR. When the UCSB load is complete, the 
following message is displayed: 

UCSB load complete. 
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If there are any EBCDIC characters defined on the print chain that the 
system is not using, the system displays the following message: 

The following EBCDIC print train characters are 
unused: 

<hexvaluel> <hexvalue2> ... 

Each hex value represents an EBCDIC character. This message is useful 
to determine which characters are still available for mapping, and should 
not be considered an error. 

The File Control Buffer (FCB) parameter should be used only when you 
want to overwrite or reload the default forms control buffer in a parallel 
printer connected to an Ultimate S/370 or S/390 system. Before loading 
a new FCB, make sure that the forms have been aligned to the correct 
position. 

Specify the fcb-item-ID parameter on a printer that supports FCBs. The 
logical printer is assumed to be stopped and inactive. SP-STARTLPTR 
loads the specified fcb-item-ID to change default paging characteristics. 

Loading an FCB does not automatically change the printer page depth 
known by the general system. Use TERM, SET-TERM, or PRINTER to 
change page depth. 

When the FCB load is complete, the system displays the following 
message: 

FCB load complete. 

It can also display unusable print positions on the print chains, such as 
IBM error messages 1311 and 1312. 
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Available 

See Also 


2-412 


:SP-STARTLPTR 

1, OJ 

Start logical printer 1 with job queue 0. 

:SP-STARTLPTR 

1, (0,3,11) 

,2,P1J 



Start logical printer 1 with job queues 0, 

3, and 11, skip 2 pages between jobs, 
and define the printer as parallel printer 1. 

:SP-STARTLPTR 

1/0,,,A—1 

Start logical printer 1 with job queue 0, 
and enter alignment mode. 

:SP-STARTLPTR 

1 QUEUE=0 

SERIAL=44 EJECT=0 ALIGNJ 



Use keywords to start logical printer 1 
with job queue 0, define the printer as 
serial printer 44, don’t skip any pages 
between jobs, and enter alignment mode. 


On SYSPROG or SECURITY account. 


SP-DELETELPTR 

SP-LISTLPTR 

SP-MENU 

SP-STOPLPTR 
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SP-STATUS 

SP-STATUS displays the status of the spooler and of each logical printer. 

Syntax sp-status {n} {(p} 

n Specifies the logical printer for which status should be 

displayed. If omitted, the status of all logical printers is 
displayed. 

(P Routes output to the spooler. 

Description Use SP-STATUS to display the status of the spooler and all printers. The 

spooler is displayed as active or inactive. To be active, the spooler must 
have one or more print jobs actively printing on a physical printer device. 

For each printer, the display shows its type and status, job queues, and 
the number of page skips between jobs. If the printer is active, the 
report shows the print job entry number currently being printed on the 
physical printer device. 


:SP-STATUSJ 



[1200] 

The spooler is active. 



[1210] 

Printer #0 is parallel/ 

active and on line. 

[1221] 

The printer is defined 

as parallel printer # 0. 

[1229] 

Print file being output 

is element 8, a 

closed 


file for line # 6 generated on account 

DP, which 


is 13 frames long. 



[1240] 

Assigned output queues: 

0 . 


[1243] 

The number of inter-job 

pages to eject 

is 0 . 

[1210] 

Printer #1 is serial, inactive, and on 

line. 

[1222] 

The printer is running 

on line 51. 


[1240] 

Assigned output queues: 

5. 


[1243] 

The number of inter-job 

pages to eject 

is 0 . 


Available On Any user account. 

See Also sp-menu 

SP-LISTLPTR 
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SP-STOPLPTR 

SP-STOPLPTR directs the spooler to stop a logical printer at the end of 
the current print job. 


Syntax sp-stoplptr n 

n Specifies the logical printer to stop. 


Description SP-STOPLPTR causes the logical printer to stop printing queued print 
jobs after completing the print job currently being output. 

Note: To stop the job currently being output, use SP-KILL. To stop 
jobs, but not the printer, use SP-DEQ. To delete a printer after 
it has been stopped, use SP-DELETELPTR. 

If the current print job is to print multiple copies, the printing stops after 
the current copy being printed; subsequent copies are not printed. If the 
current print job is a hold file, it is retained. If not, the print job is 
removed from the job queue. 

Only one user at a time can issue SP-STOPLPTR to a specific printer. 

The logical printer remains stopped until restarted by SP-STARTLPTR. 


: SP-STOPLPTR 2J 

[1170] Printer # 2 set to stop and is inactive. 


Available On sysprog or security account. 

See Also sp-deletelptr 

SP-DEQ 

SP-KILL 

SP-LISTLPTR 

SP-MENU 

SP-STARTLPTR 

2-414 Ultimate System Commands Guide 6985-3.2 

Confidential and Proprietary to The Ultimate Corp. 



SP-TAPEOUT 


SP-TAPEOUT 


SP-TAPEOUT transfers the contents of a tape file to the spooler. 


Syntax 


SP-TAPEOUT {A} (u} (SP-ASSIGN parameters} 


A Converts tape data to ASCII format before transfer to 

the spooler. Assumes tape data is in EBCDIC format. 

U Converts all alphabetic characters to uppercase before 

transfer to the spooler. 


SP-ASSIGN Sets up the spooler assignment for the print job. Can 
parameters be any combination of options available in SP-ASSIGN 
except T. 


Note: If parameters are omitted, the command uses the current SP- 
ASSIGN spooler assignments, transfers without changing any 
data to uppercase, and assumes tape data is in ASCII format. 


Description Use SP-TAPEOUT to print a tape file or output it to another device. If 
your system has multiple tape drives, T-ATT must be used to attach a 
tape unit before executing SP-TAPEOUT. 

If SP-ASSIGN parameters are omitted, the current spooler assignment can 
not contain a T option. The system assumes that the tape is at the 
location of the file to be transferred. The tape file is normally, but not 
necessarily, the result of output under SP-ASSIGN with the T option. 

On single tape drive systems, SP-TAPEOUT executes a T-ATT, then 
transfers the contents of the tape file to the spooler. The spooler creates 
a print job using the contents of the tape file as the data to be output. 

If both the A and U options are specified, the characters are first 
converted to ASCII and then to uppercase. 


6985-3.2 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


2-415 




SP-TAPEOUT 


Available 

See Also 


: SP-TAPEOUT AJ 


Output the tape in ASCII format. 


On Any user account. 


SP-ASSIGN 

T-ATT 
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SPIE 

Syntax 


Description 

Available On 

6985-3.2 


SPIE is an UltiPlot command that generates a sorted list of items and 
uses this list to produce a pie chart. SPIE is a graphic equivalent of the 
SORT command. 


SPIE filename {itemlist} {sel-criteria} {sort-criteria} 
{output-specifications} {(options} 


filename Specifies the file containing the items to be charted. 

itemlist Specifies one or more explicit item-IDs. If specified, 

each item-ID must be enclosed in single quotes. If 
omitted, the command acts on the current select-list, 
or on all items in the file if no select-list is present. 

sel-criteria Conditions that must be met by an item in order for it 
to be charted. Also known as a WITH clause. 


sort-criteria Specifies sorting sequence. Also known as a BY clause. 

output- Specifies the attributes and values in the selected 

specifications items that should be charted. 


(options 

C Suppresses column heading lines that define 

attributes in a report. 

D Suppresses all detail lines from a report. 

H Suppresses the report's page heading line and "n 

items listed" line. 

I Suppresses the item-ID column or row heading. 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 


For further information on SPIE, please refer to UltiPlot Reference 
Guide. 


Any user account. 
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SPLOT 


Syntax 


Description 

Available On 

2-418 


SPLOT is an UltiPlot command that generates a sorted list of items and 
uses this list to produce a rectangular chart, bar graph, line graph, or 
scatter diagram. SPLOT is a graphic equivalent of the SORT command. 


SPLOT filename {itemlist} {sel-criteria} {sort-criteria} 
{output-specifications} {(options} 


filename Specifies the file containing the items to be charted. 

itemlist One or more explicit item-lDs. If specified, each 

item-ID must be enclosed in single quotes. If 
omitted, the command acts on the current select-list, 
or on all items in the file if no select-list is present. 

sel-criteria Conditions that must be met by an item in order for it 
to be charted. Also known as a WITH clause. 


sort-criteria Specifies sorting sequence. Also known as a BY clause. 

output- Specifies the attributes and values in the selected 

specifications items that should be charted. 


(options 

C 

D 

H 

I 

N 

P 


Suppresses column heading lines that define 
attributes in a report. 

Suppresses all detail lines from a report. 

Suppresses the report's page heading line and "n 
items listed" line. 

Suppresses the item-ID column or row heading. 
Specifies no automatic end-of-page waiting. 
Routes output to the spooler. 


For further information on SPLOT, please refer to UltiPlot Reference 
Guide. 


Any user account. 
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SREFORMAT 


Syntax 


Description 

Available On 

6985-3.2 


SREFORMAT is an Ultimate RECALL command that creates a new file 
from specified items in a file, according to specific selection criteria, 
modifiers, and options. 


SREFORMAT filename {itemlist} {sel-criteria}{sort-criteria} 
{output-specifications} {(options} 


filename Specifies the file containing the items to be sorted 

and reformatted. 


itemlist Specifies one or more explicit item-lDs. If specified, 

each item-ID must be enclosed in single quotes, 
double quotes, or backslashes. If omitted, the 
command acts on the current select-list, or on all 
items in the file if no select-list is present. 

sel-criteria Conditions that must be met by an item in order for it 
to be processed. Also known as a WITH clause. 


sort-criteria Specifies the sorting sequence. Also known as a BY 
clause. 


output- Specifies the attributes and values in the selected 

specifications items that should be processed. 


(options 

C Suppresses column heading lines that define 

attributes in a report. 

H Suppresses the report's page heading line and "n 

items listed" line. 

I Suppresses the item-ID column or row heading. 


Note: This command can also use the TAPE modifier. 


For further information on SREFORMAT, please refer to the Ultimate 
RECALL and Ultimate UPDATE User Guide. 


Any user account. 
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SSELECT 

SSELECT is an Ultimate RECALL command that creates a sorted select- 
list from specified item-IDs or attribute values. 

Syntax SSELECT filename {itemlist} {sel-criteria}{sort-criteria} 

{output-specifications {print-limiters}} 

filename Specifies the file containing the items to be sorted 

and selected. 

itemlist One or more explicit item-IDs. If specified, each 

item-lD must be enclosed in single quotes, double 
quotes, or backslashes. If omitted, the command 
acts on the current select-list, or on all items in the 
file if no select-list is present. 

sel-criteria Conditions that must be met by an item in order for it 
to be sorted and selected. Also known as a with 
clause. 

sort-criteria Specifies the sorting sequence. Also known as a BY 
clause. 

output- Specifies the attributes and values in the selected 

specifications items to be used to create the select-list. 

print-limiters Restricts the printing of output specification to values 
that meet the limit conditions. 

Description For more information on SSELECT, please refer to the Ultimate RECALL 

and Ultimate UPDATE User Guide. 

Available On Any user account. 
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START-RESYNC 

START-RESYNC issues a DISK-RESYNC command, followed shortly by a 
DISK-STATUS command. 


Syntax START-RESYNC source destination 

source Specifies channel address of the disk that is already 
running as part of the system. Enter in hexadecimal 
without a preceding period. 

destination Specifies channel address of a disk that is to be made a 
sib of (shadow) the source disk. Enter in hexadecimal 
without a preceding period. 

Description Because disk problems can cause DISK-RESYNC to fail shortly after it 

begins execution, START-RESYNC provides as a convenient way to 
execute DISK-RESYNC, wait a while, then display the status of the 
resynchronization in case any initial failures have occurred. If START- 
RESYNC does not indicate an error, resynchronization usually proceeds 
to a successful completion, stopped only by a hard disk error on the 
destination disk or a system reboot. 


:START-RESYNC 2880 E080J 

[361] Disk resynchronization started. 

Current Disk Subsystem Status 10:19:55 14 AUG 1991 


Dynamic 

Volume 

1 

2 


resynchronization is in progress. 

Channel(s) Status 

2800/E000 Both running shadowed. 

2880/E080 2880 is being copied to E080. 

0% done. 


Available On SYSPROG account on Ultimate Bull 7000 systems. 


See Also DISK-RESYNC 

DISK-STATUS 
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STAT 


Syntax 


Description 


Available On 


2-422 


STAT is an Ultimate RECALL command that accumulates and reports the 
total of all the values of one attribute name for a selected set of file 
items. It also provides a count of the number of items selected and their 
average value. 


STAT filename {itemlist} {sel-criteria} {attr} 


filename Specifies the file containing the items to be processed. 

itemlist Specifies one or more explicit item-lDs. If specified, 

each item-ID must be enclosed in single quotes, double 
quotes, or backslashes. If omitted, the command acts on 
the current select-list, or on all items in the file if no 
select-list is present. 


sel-criteria Conditions that must be met by the specified attr value 
in an item in order for the item to be processed. Also 
known as a WITH clause. 


attr 


Specifies the value of a single attribute to be processed in 
the item. If omitted, the entire item is processed. 


For further information on STAT, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 


Any user account. 
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STATUS 

STATUS indicates the general type of processing being performed on one 
or more lines. STATUS is also available as an option on the ON-LINE- 
DIAGS menu. 

Syntax status (n {n}...} {(p)} 

n Specifies the line number for which status is to be 

reported. Multiple lines must be separated by spaces. If 
omitted, the status of all logged-on lines is reported. 

(P Routes output to the spooler. 

Description Use STATUS to view the processing status of one or more lines. 

STATUS is similar to WHERE, except that STATUS provides descriptions 
of the ABS (assembly-language) frames and the PIB (Process 
Identification Block) status bits, in place of raw numbers. 

For each line specified, STATUS displays the name of the account logged 
on to that line, a brief description of the assembly-level software currently 
being executed, and the PIB status bits. STATUS also provides an 
interpretation of the status bits, for example, showing whether a line is 
performing terminal input, terminal output, or waiting for input. 


:STATUS 0 

3 15 J 



Name .... 

Frame ID.. 

..Status 


0 SYSPROG 

WHERE 

0000 

Running 

3 ACCTING 

SYSTEM 

0210 

Input roadblocked/pending 

15 SPOOLER 

SPOOLER 

4000 

Sleeping 


Available On sysprog or security account. 

See Also listu(sers) 

ON-LINE-DIAGS 

WHERE 
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STRIP-PARITY 


STRIP-PARITY restores the normal input communication format of 7-bit 
ASCII characters plus a parity bit on a specified line. 


Syntax strip-parity {n} 

n Specifies the line for which STRIP-PARITY mode should 

be set. If omitted, the current line is assumed. 


Description STRIP-PARITY can be used to resume receiving data at the system default 

mode of 7-bit ASCII characters plus a parity bit. STRIP-PARITY assumes 
that the line has previously been set by SAVE-PARITY to allow 
transmission of 8-bit transparent data. 

STRIP-PARITY sets the receive-data mode so that the high-order bit is 
stripped from the incoming data stream. This is the normal mode, 
where the 7-bit ASCII character is assumed. 

Once a line has been reset by STRIP-PARITY, it remains in the normal 
mode until set again by SAVE-PARITY. SAVE-PARITY sets the line to the 
8-bit mode. 

A coldstart resets all lines to the system default mode (the STRIP-PARITY 
mode). A warmstart, however, does not change the current mode on 
any line. 


: STRIP-PARITY 4J 


Available On sysprog or security account. 


See Also SAVE-PARITY 
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STRIP-SOURCE 

STRIP-SOURCE creates copies of assembly language program items with 
all source language statements deleted. 


Syntax STRIP-SOURCE filename {itemlist} 

filename Specifies the file from which the items listed in the 
itemlist are to be accessed and copied 

itemlist Specifies one or more explicit item-lDs, or an asterisk (*) 
to specify all items in the file. Can be omitted if a select- 
list is present. 


Description Use STRIP-SOURCE to create an assembly language program item that 
contains only object code. These stripped items can be loaded and 
verified using MLOAD and MVERIFY, but cannot be re-assembled. 

Once a filename and itemlist are entered, STRIP-SOURCE prompts for a 
destination file name. After processing, the destination file contains 
stripped versions of each source item, leaving the original items 
unchanged. 

The first six lines of each program item are assumed to be comment 
lines and are not stripped. 


:STRIP-SOURCE .MODES *J 

Destination file: OBJECT.CODE 


Available On sysprog or security account. 

See Also as 

ASM (Ultimate 1400 systems) 

OPT (IBM S/370 and S/390 systems) 

MUST 

MLOAD 

MVERIFY 

Ultimate Assembly Language Reference Guide 
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SUBD 

Syntax 

Description 

Available On 

See Also 


2-426 


SUBD subtracts two decimal integers. 

SUBD n m 

n Specifies the first decimal integer, 

m Specifies the second decimal integer. 

SUBD subtracts two decimal numbers. These numbers can range from 0 
(zero) to ±140737488355327. 

: SUBD -2 0 5J 

-25 


Any user account. 

SUBX 
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SUBX 

Syntax 

Description 


Available On 

See Also 


6985-3.2 


SUBX subtracts two hexadecimal numbers. 

SUBX n m 

n Specifies the first hexadecimal number, 

m Specifies the second hexadecimal number. 


SUBX subtracts one positive or negative hexadecimal number from 
another. Negative numbers can range from FFFFFFFFFFFF to 
800000000001. Positive numbers can range from 0 to 7FFFFFFFFFFF. 
If fewer than 12 hexadecimal characters tire entered, high order zeroes 
are assumed. 


: SUBX 7FFF 20 J 

7FDF 


Any user account. 


SUBD 
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SUM 


Syntax 


Description 


Available On 


2-428 


^ X 


SUM is an Ultimate RECALL command that accumulates and reports the 
total of all the values of one attribute name for a selected set of file 
items. 


SUM filename {itemlist} {sel-criteria} {attr} 


filename Specifies the file containing the items to be processed. 


itemlist Specifies one or more explicit item-IDs. If specified, 
each iteni-ID must be enclosed in single quotes, double 
quotes, or backslashes. If omitted, the command acts on 
the current select-list, or on all items in the file if no 
select-list is present. 


sel-criteria Conditions that must be met by the specified attr value 
in an item in order for the item to be processed. Also 
known as a WITH clause. 

attr Specifies the value of a single attribute to be processed in 

the item. If omitted, the entire item is processed. 



For further information on SUM, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 


Any user account. 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


6985-3. 


2 




SYS-GEN 


SYS-GEN 


SYS-GEN is used to create a SYS-GEN tape during a Method 1 upgrade, 
and should not be used at any other time. 

For further information on SYS-GEN, please refer to the upgrade 
procedure for your system. 
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SYSMON 

Syntax 

Description 


2-430 



SYSMON invokes the performance monitor, which measures and 
displays Ultimate S/370 and S/390 system activity. 


SYSMON 


The performance monitor uses a series of screens to display information 
about system activity, as follows: 


Screen Name 

Description 

PARM 

Used to specify the operational parameters. 

MAIN 

Displays system activity and line usage data. 

DISK 

Displays summary of disk utilization. 

STAT 

Displays detailed statistics on use of system 
resources. 

VIRT 

Displays cumulative statistics on use of virtual 
locks. 

VIRTI 

Displays interval statistics on use of virtual locks. 


When SYSMON is invoked the first time, the PARM screen is displayed. 
When SYSMON is invoked subsequently, it immediately begins 
accumulating values for the first sample period and displays a message 
similar to the following: 

MONITOR ACCUMULATING INITIAL STATISTICS FOR THE NEXT 
xx SECONDS 

The MAIN screen is then displayed. 

These screens are described in detail in the following sections. 
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Screen Values 

The values for all the screens are calculated at the end of each sample 
period. Thus, when you move from one screen to another, the values 
displayed are for the same sample period. If the number of digits to be 
displayed exceeds the maximum specified for an entry, the value is 
divided by 1000 and a K is appended to indicate the value has been 
scaled. If the number of digits is still too large, the value is again 
divided by 1000 and an M is appended to the value. If the number of 
digits is still too large, the value is again divided by 1(X)0 and a G is 
appended to the value. 


Command Prompt 


Each screen has a command prompt. The following commands are 
available on any of the screens, except where noted: 

DISK 

Displays DISK screen. 

EXIT 

Exits to TCL. 

HELP 

Lists the names of available commands. 

FREE 

Restarts the display of updated statistics. 

HOLD 

Stops the display of updated statistics based on 
new samples; the sampling continues. 

MAIN 

Displays MAIN screen. 

PAGB 

Displays previous page; available only on MAIN 
and DISK screens. 

PAGF 

Displays next page; available only on MAIN and 
DISK screens. 

PARM 

Displays PARM screen. 

STAT 

Displays STAT screen. 

VIRT 

Displays VIRT screen. 

VIRTI 

Displays VIRTI screen. 


To redisplay the data on the screen, press ENTER. 
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Top of Screen 

The top line of each screen is similar to the following: 

date time scrn ULTIMATE SYSTEM MONITOR vmuserid serial, n 


where: 

date 

time 

scrn 

vmuserid 
serial.n 


Current date. 

Time the current sample was taken. 

Screen name. 

For VM systems, displays the VM user id. 
Ultimate system serial number. 


Executing From More Than One Terminal 

SYSMON can be executed from more than one terminal at a time. 
However, since the kernel cannot tolerate more than one inquiry per 
sample period, SYSMON is designed to use previously stored historical 
data to supply the information for other tenninals using the performance 
monitor. The data is stored in the SYSMON.HISTORY file in SYSPROG. 

This means that any terminal running the monitor must be logged onto 
SYSPROG or have a Q-pointer to the file SYSMON.HISTORY. If the 
program is run from SYSPROG and the file does not exist, it is created. 
However, if the program is run from an account other than SYSPROG 
and the file does not exist, the program returns to TCL. (The format of 
items in this file is described in the section SYSMON.HISTORY File.) 

The terminal that first started the performance monitor is the master 
terminal, and only the master terminal can set sampling parameters. In 
order for other terminals to use the monitor, the master terminal must 
specify Y at the following prompt on the PARM screen: 

WRITE HISTORICAL DATA TO FILE 

For more information on the PARM screen, see the PARM Screen 
section. 
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Use of 
Historical 
Data File 


If the master terminal exits the performance monitor, another terminal 
running the monitor becomes the master and that terminal does the 
sampling. 


The historical data file (SYSMON.HISTORY) created by SYSMON can be 
used for several purposes, including constant analysis, capacity 
planning, and load balancing. 

The file is useful for both immediate and archive-based reporting. In 
some cases, fields in the file are cumulative from IPL (or midnight), 
permitting selection of every nth record, thus reducing the number of 
records to be released. 

Reports can be created using Ultimate RECALL, ULTIPLOT, or BASIC. 
Since every computer installation is slightly different, no archive 
methods are described here. Each site must decide how often and where 
to save performance data. 

However, since the overhead of the monitor increases when its file is 
full, care should be taken to empty (archive) the file periodically. Make 
sure the file can contain the number of records written between each 
archive. 
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PARM Screen The first time SYSMON is invoked, or thereafter when PARM is entered 

at the command prompt, a screen similar to the following is displayed: 

(^date time PARM ULTIMATE SYSTEM MONITOR vmuserid serial.no ^ 


PROGRAM OPERATION PARAMETERS 

1. SAMPLING INTERVAL [SECONDS] (30-600) 030 

2. SAMPLES TO AVERAGE [5-100] 010 

3. WRITE HISTORICAL DATA TO FILE [Y/N] Y 

4. ENABLE REAL MEMORY DISPLAY/ALTER [Y/N]N 

5. LINE NUMBER TO ALWAYS MONITOR 


10. MASTER PROCESS NUMBER n <- THIS PROCESS 

11. ACCOUNT RUNNING MASTER PROCESS current acct 

12. ITEMID OF CURRENT CAPTURE RECORD date*time*sys.type*vmuserid 

ENTER LINE # TO CHANGE, 'SAVE', OR 'EXIT' 

V_ ) 

This screen is used to specify the parameters that determine the length of 
time each sample is to take and the number of samples to use in 
determining the system statistics. The default is 30-second samples and 
10 samples per average. 

This is the first screen displayed, unless SYSMON has been executed 
previously or is being executed from more than one terminal; in that 
case, this screen is skipped and the MAIN screen is displayed. 

To change one of the parameters, enter the number of the line. Only 
lines 1 through 5 can be changed. To continue with the program, enter 
SAVE. This takes you to the MAIN screen. To exit to TCL, enter EXIT. 

Each line of the PARM screen is described below: 
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1. SAMPLING INTERVAL The time, in seconds, to use for each 

sample. The range is 30-600 seconds. 
The default is 30. 

2 . SAMPLES TO AVERAGE The number of samples to take. The 

range is 5-100. The default is 10. 

3. WRITE HISTORICAL To save data to a file, enter Y. If the 

DATA TO FILE data is not to be saved, enter N. If more 

than one user wants to run this program 
at a time, this parameter must be Y. The 
default is N. 


4. ENABLE REAL Currently, this option is not imple- 

MEMORY mented; the option should remain N. 

DISPLAY/ALTER 


5. LINE NUMBER TO The MAIN screen can display a 

ALWAYS MONITOR maximum of 12 lines on the first page, 

24 total. If a specific line should 
always be displayed, enter its line 
number here. 


10. MASTER PROCESS The line number of the master process; 
NUMBER if the current line is the master, the 

characters THIS PROCESS are displayed. 
(This parameter is for display only.) 


11. ACCOUNT RUNNING 
MASTER PROCESS 


The name of the account that is the 
master process. (This parameter is for 
display only.) 


12. ITEMID OF CURRENT The item-ID under which the current 
CAPTURE RECORD statistics will be saved in the 

SYS MON.HISTORY file. (This parameter 
is for display only.) 
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MAIN When MAIN is entered at the command prompt, a screen similar to the 

Screen following is displayed: 


r 'n 


date time 

MAIN 

ULTIMATE SYSTEM MONITOR 



vmuserid ser 

ial.no 

TOT 

OVH 

VRT DISK 

OTHER 

REF VIRT 

VIRT Q1 


2? . 

INTERVAL: nnn SEC 

CPU% 

CPU% 

CPU% ISEC 

I SEC 

MEM% PAGE 

DT.SP USER 

U 

3ER 

CAPTURE : 

Y 

--> nnn 

nnn 

nnn nnn.n 

nnn. n 

nnn nnnnn 

nnnn nnnn 

nnnn 

PAGE LEN: 

4096 

<-- nnn 

nnn 

nnn nnn.n 

nnn. n 

nnn nnnnn 

nnnn nnnn 

nnnn 

AVAIL CPU%: 

nnn.n 

LINE ACCOUNT 

NAME 

Q 

STS CPU% 

DISK Q1MS Q2MS 

LOK 

ATL EXE DSP 

DSF 

*line account 

.name! 

x 

XXX XXX.XX 

nnnn nnnn nnnn 

nnn 

nnn nnn nnn 

nnn 

line account 

. name2 

X 

XXX xxx.xx 

nnnn nnnn nnnn 

nnn 

nnn nnn nnn 

nnn 


line account, namen x xxx xxx.xx nnnn nnnn n'nnn nnn rum nnn nnn nnn 

ENTER COMMAND: 

v_/ 


This screen displays both the total CPU activity and the individual line 
use of system resources. The information on the line preceded by 
indicates the current sample, while the information on the line preceded 
by "<—" indicates the averaged values. 

The following statistics are displayed: 


TOT CPU% 

OVH CPU% 

VRT CPU% 


Total non-idle CPU time (OVH plus VRT time) as a 
percent of total time including idle time. 

Total CPU time performing non-virtual work, such 
as processing interrupts, selecting users to run, or 
flushing memory. 

Total CPU time running virtual processes. 
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DISK ISEC 


OTHER ISEC 


REF MEM% 


VIRT PAGE 


VIRT DISP 


Ql USER 


Q2 USER 


INTERVAL 


Number of physical disk I/O operations initiated per 
second. Note that one start I/O can read or write 
many frames. 

Number of physical non-disk I/O operations 
initiated per second. This includes terminals, tape, 
printers, and any other non-disk device. 

Percent of virtual frames in main storage that were 
recently referenced plus the number of frames that 
have been updated and need to be written back to 
disk; see the STAT screen for the number of each. 
The value for this parameter can range from 0 to 
200 %. 

Number of virtual frames in main storage. This is 
a measure of how much memory is actually 
available for virtual tasks. 

Number of virtual dispatches or activities. An 
activity is any processing that takes place for 
virtual; for example, it is an activity when a 
character is entered at the keyboard and the system 
moves it to a buffer. It is another activity when 
ENTER is pressed and the system goes to process 
the data. 

Number of processes classified as 'QT (an 
interactive process is an example of a Ql process) 
at the end of the sample interval. 

Number of processes classified as 'Q2' (batch 
process is an example of a Q2 process) at the end of 
the sample interval. 

Actual number of seconds between samples, 
rounded to the nearest second. The actual elapsed 
time can be greater, depending on system load. 

(The actual elapsed time, rounded to the nearest 
millisecond, is used for 'per second' calculations 
and is saved in the SYSMON.HISTORY file.) 
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CAPTURE 

PAGE LEN 

AVAIL CPU% 

LINE 

ACCOUNT NAME 

Q 


Y indicates the performance data is being written to 
SYSMON.HISTORY; N indicates that it is not being 
written. In order for more than one terminal at a 
time to use the performance information, this must 
be Y. 

System hardware page size. This can be different 
from Ultimate frame size; if it is, there might be 
performance problems. 

Percent of CPU time available to the Ultimate 
system. This is calculated by dividing the number 
of milliseconds that Ultimate could have had 
control of the CPU by the wall clock time in 
milliseconds. On a VM system, this measures the 
CPU resources that are being used by other virtual 
machines, by subtracting the value shown from 
100 percent. 

Line number: 

* Indicates the current line. 

@ Indicates that the process is always to be part of 
the sample 

Account the process is logged on to, from ACC 
attribute 1. 

Indicates the type of process; can be one of the 
following: 

A process is permanently in Ql 

B process is permanently in Q2 

X process ran in both Ql and Q2 during sample 
interval 

1 process was only in Ql during the sample 
interval 

2 process was only in Q2 during the sample 
interval 
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STS 


CPU% 

DISK 

QlMS 

Q2MS 

LOK 

ATL 

EXE 

DSP 

DSF 


Indicates status at end of sample period; can be one 
of the following: 

RUN run at end of sample period 
INP waiting for input 

SLP waiting for a specific time to elapse (for 
example, RQM, SLEEP) 

DSK waiting for a frame to be read from disk 

OUT waiting for terminal output to be written to 
the terminal/printer 

Percent of total virtual CPU resource consumed by 
this process. 

Number of frame faults requested during sample 
interval. 

Time spent executing as a Ql user (in milliseconds). 

Time spent executing as a Q2 user (in milliseconds). 

For all processes but the spooler, number of virtual 
locks requested (the actual number of locks 
acquired is this number less the ATL value). For 
spooler processes, indicates internal activity of 
spooler. 

For all processes but the spooler, number of times 
a virtual lock was requested, but unavailable. For 
spooler processes, indicates the number of serial 
printers jobs that were initiated plus the number of 
times a lock was requested, but unavailable. 

Number of times system assigned a new execute 
level to a process. 

Number of activities during the sample period. 

Number of times this line was not activated during 
the sample period due to a required frame not being 
in memory. As this number increases, it indicates 
more difficulty in starting a process to run 
(thrashing). 
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DISK Screen When DISK is entered at the command prompt, a screen similar to the 
following is displayed: 

/-'N 

date time DISK ULTIMATE SYSTEM MONITOR vmuserid serial.no 

SERV -INTERVAL —CUMULATIVE- I/O QUE 

CCUU VOLSER MS. READ WRIT READ WRITE ERR TIME LEN BSY% 
xxxxx xxxxxx nn.n nnnn nnnn nnnnn nnnnn nnn nnn.n nn.n nn.n 


xxxxx xxxxxx nn.n nnnn nnnn nnnnn nnnnn nnn nnn.n nnn nn.n 


ENTER COMMAND: 






This screen displays the following statistics on disk usage: 


CCUU 

Channel address of the disk. For IBM VM systems, 
this is a virtual address. 

VOLSER 

Name given the disk by the user. 

SERV MS. 

Milliseconds per frame read or write. This is 
intended to measure how efficiently the disk itself 
is operating. It does not measure delays caused by 
queueing the I/O operation. 

INTERVAL READ 

Number of frame reads done during the sample 
period. 

INTERVAL 

WRITE 

Number of frame writes done during the sample 
period. 


CUMULATIVE Total number of frame reads done since last IPL. 
READ 
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CUMULATIVE Total number of frame writes done since last IPL. 

WRITE 

CUMULATIVE Total number of errors (both correctable and non- 

ERR correctable) since last IPL. 

I/O TIME Average time to perform a complete I/O operation 

during the sample period. This might include many 
reads and writes (see QUE LEN). 

QUE LEN Average number of reads and writes per disk 

operation. 

BSY% Percent of time that the system found the disk busy 

when trying to start an operation. This also 
includes controller and bus (IBM channel) busy 
conditions. 

Note: If a disk has no activity during an interval, the SERV MS., I/O 
TIME, and QUE LEN are shown as zero. 
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STAT When STAT is entered at the command prompt, a screen similar to the 

Screen following is displayed: 


' 1 

date time STAT ULTIMATE SYSTEM MONITOR vmuserid serial.no 


■CPU%----PAGES 


TOT 

WAIT 

EXT 

I/O 

DISP 

ECB 

Ql 

Q2 

VIRT 

REF 

WRQ 

ABS 

W/S 

MON 

— > nnn 

nnn 

nnn 

nnn 

nnn 

nnn 

nnn 

nnn 

nnnnn 

nnnnn 

n n n n n 

n n n n 

n n nnn 

nnnnn 

<-- nnn 

nnn 

nnn 

nnn 

nnn 

nnn 

nnn 

nnn 

nnnnn 

nnnnn 

nnnnn 

nnnn 

nnnnn 

nnnnn 


Renter command:__ I 
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This screen displays the following detailed breakdown of the statistics 
displayed on the first screen: 


CPU% TOT 


Same as TOT CPU% on main screen. 


CPU% WAIT 

CPU% EXT 


Percent of time the system was idle during the 
sample period. 

Percent of time the system was handling timer- 
based events. 


CPU% I/O Percent of time the system was handling I/O 

operations and interrupts. 

CPU% DISP Percent of time the system was dispatching a 

process (selecting the process to run, attaching its 
registers, and getting it ready to run). 

CPU% ECB Percent of time the system was running kernel- 

related work not shown above. 


CPU% Ql 


Percent of time the system was running Ql 
processes. 
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CPU% Q2 

Percent of time the system was running Q2 
processes. 

PAGES VIRT 

Same as VIRT PAGE on main screen. 

PAGES REF 

Number of virtual frames that were recently 
referenced. 

PAGES WRQ 

Number of virtual frames that were recently 
changed and have not yet been flushed to disk. 

PAGES ABS 

Number of ABS frames in main memory. 

PAGES W/S 

Number of workspace frames in main memory. 
This does not include EXECUTE workspaces. 

PAGES MON 

Number of pages converted to kernel use, over and 
above the number of pages allocated at IPL. 
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VIRT Screen When VIRT is entered at the command prompt, a screen similar to the 

following is displayed: 


date time VIRT ULTIMATE SYSTEM MONITOR 

-GROUP LOCKS- 


vmuserid serial.no 


MAIN 

NETWK 

GOT 

TBL 

LOCK 

LOCK 



CALLS 

CALLS 

LOCK 

FULL 

HELD 

RTRY 



nnnnnn 

nnnnnn 

nnnnnn 

nnnnn 

nnnnn 

nnnnn 






— ITEM 

LOCKS- 



— 

MAIN 

RTNALL 

GOT 

TBL 

LOCK 

LOCK 

WRTLK 

WR 1 

CALLS 

CALLS 

LOCK 

FULL 

HELD 

RTRY 

HELD 

FU 

nnnnnn 

nnnnnn 

nnnnnn 

nnnnn 

nnnnn 

nnnnn 

n n n n n 

nn. 


-READ LOCKS- -READ ITEM- 

MAIN WRTLK WRTLK GLOCK LOCK TBL ADD OVF MAIN RTNALL NOT 

CALLS HELD HELD + FULL RTRY FULL FRM ERR CALLS CALLS LOCKD 

nnnnnn nnnnn nnnnn nnnnn nnnnn nnnnn nnn nnn nnnnnn nnnnnn nnnnnn 

-—WR ITE LOCKS- 

MAIN GOT NOT RDLK RDLK 

CALLS LOCK LOCKD HELD HELD+ 

nnnnnn nnnnnn nnnnnn nnnnnn nnnnnn 

^ ENTER COMMAND: _____ y 

This screen displays the following statistics on locks set by the system: 


GROUP LOCKS: 
MAIN CALLS 

NETWK CALLS 


Number of times the group lock routine "wait if 
group lock cannot be obtained" was called. 

Number of times the group lock routine "do not 
wait if group lock cannot be obtained" was 
called. This is used, for example, by UltiNet. 
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GOT LOCK 
TBL FULL 

LOCK HELD 

LOCK RTRY 

ITEM LOCKS: 

MAIN CALLS 

RTNALL CALLS 

GOT LOCK 
TBL FULL 

LOCK HELD 

LOCK RTRY 

WRTLK HELD 

WRTLK FULL 

GLOCK RTRY 

READ LOCKS: 

MAIN CALLS 


Number of times group lock was obtained. 

Number of times group lock was not acquired 
because group lock table is full. 

Number of times group lock was not acquired 
because some other process held that lock. 

Number of times process looped in group lock 
routine trying to acquire a lock. 


Number of times the item lock routine "spin 
until lock obtained" was called. 

Number of times the item lock routine "do not 
wait if lock cannot be obtained" was called. 

Number of times item lock was obtained. 

Number of times item lock was not acquired 
because item lock table full. 

Number of times item lock was not acquired 
because that lock held by another process. 

Number of times process looped in item lock 
routine trying to acquire a lock. 

Number of times item lock was not acquired 
because a write group lock was held by another 
process. 

Number of times item lock was not acquired 
because the write group lock table was full. 

Number of times item lock routine had to retry 
locking a group. 


Number of times read lock routine called to get 
a read lock. 
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WRTLK HELD 


Number of read lock calls that failed because a 
write lock was held by another process. 


WRTLK HELD+ Number of read lock calls that failed because a 
write lock persisted after an attempt to free the 
lock by activating the locking process. 

GLOCK FULL Number of read lock calls that failed because 
the group lock table was full. 


LOCK RTRY Number of times read lock routine retried 
getting a lock after a failure. 

TBL FULL Number of times the read lock routine found its 

table full. 


ADD FRM Number of times read lock routines expanded 

the read lock table. 

OVF ERR Number of times the read lock routines could 

not expand the read lock table because no 
available space frames were available. 


READ ITEM: 

MAIN CALLS Number of calls to read an item for update. 

RTNALL CALLS Number of calls to read an item for update that 

would not wait if a lock was held. 

NOTLOCKD Number of times that a read lock for update 
failed. 


WRITE LOCKS: 

MAIN CALLS Number of calls to get a write lock for the 

purpose of updating an item. 

GOT LOCK Number of times lock was obtained. 

NOTLOCKD Number of times lock was not obtained. 





Ultimate System Commands Guide 6985-3.2 

Confidential and Proprietary to The Ultimate Corp. 



SYS MON 


VIRTI 

Screen 


SYSMON. 

HISTORY 

File 
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RDLK HELD Number of times lock was not obtained because 
a read was underway on the same group. 

RDLK HELD+ Number of times that another process holding 
the desired lock was run to try and free the 
lock. 


The VIRTI is exactly the same as the V1RT screen, except the statistics are 
displayed for the last sample interval only. 


Data that is used in preparing the screens can be captured and saved to 
the SYSMON.HISTORY file by specifying Y at prompt 3 (WRITE 
HISTORICAL DATA TO FILE) in the PARM screen. 

Data is stored in the SYSMON.HISTORY file in the following format: 

item.id date*time*system.type*vmuserid 

001 SYSMON version number (currently 1.0) 

002 number of milliseconds in current sample 
003 reserved 

004 total WAIT (idle) milliseconds since midnight 

005 total EXT CPU milliseconds since midnight 

006 total I/O CPU milliseconds since midnight 

007 total DISP (dispatcher) CPU milliseconds since midnight 

008 total ECB (kernel) CPU milliseconds since midnight 

009 total Ql CPU milliseconds since midnight 

010 total Q2 CPU milliseconds since midnight 

011 total memory size in pages 

012 ''number of recently referenced pages 

013 number of recently modified pages 

014 number of virtual pages converted to kernel use 

015 internal use only 

016 internal use only 

017 number of core locked pages 

018 number of pages that have I/O errors outstanding 

019 internal use only 

020 internal use only 

021 internal use only 

022 number of ABS frames in memory 
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023 number of primary and extended workspace frames in 
memory (excluding frames used by EXECUTE) 

024 number of data frames and EXECUTE workspaces in 
memory 

025 accumulated number of successful process dispatches 
since IPL 

026 number of Ql processes 
027 number of Q2 processes 

028 accumulated number of attempted process dispatches 
since IPL 

029 internal use only 

030 internal use only 

031 internal use only 

032 internal use only 

033 internal use only 

034 internal use only 

035 internal use only 

036 internal use only 

037 internal use only 

038 internal use only 

039 internal use only 

040 internal use only 

041 internal use only 

042 accumulated total disk reads since IPL 

043 accumulated total disk writes since IPL 

044 accumulated disk start I/O operations 

045 accumulated non-disk start I/O operations 

046 reserved 

047 reserved 

048 reserved 

049 reserved 


Attributes 50 through 64 are multivalued, with each value in attributes 
51 through 64 relating to the disk address in the corresponding value in 
attribute 50. 


050 disk address 

051 disk volume number (VOLSER) 

052 accumulated number of read operations since IPL 

053 accumulated number of write operations since IPL 



X- 
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054 average number of milliseconds to read or write one 
frame during the sample period 

055 accumulated number of read and write errors since IPL 

056 accumulated number of milliseconds elapsed while I/O 

was underway to the device, during sample period; does 
not include time waiting in a queue before I/O operations 
started 

057 accumulated number of I/O operations done during 

sample period. Each start I/O counts as one operation, 
even if that start I/O operation does more than one read or 
write 

058 accumulated number of I/O operations done to the device 
since IPL 

059 accumulated number of interrupts received from the 
device since IPL 

060 accumulated number of times device found busy when 
kernel wanted to start an I/O operation since IPL 
061 reserved 
062 reserved 
063 reserved 
064 reserved 

Attributes 65 through 84 are multivalued, with each value in attributes 
66 through 84 relating to the process number in the corresponding value 
in attribute 65. 

065 process number 

066 process status in decimal; value corresponds to that 
shown by WHERE verb 

067 queues process ran in during sample interval; possible 
values are 

1 Q1 

2 Q2 

x both Ql and Q2 

A permanently in Ql 

B permanently in Q2 

068 number of CPU milliseconds executed while in Ql 

069 number of CPU milliseconds executed while in Q2 

070 number of disk frame faults 
071 number of virtual locks requested 


Ultimate System Commands Guide 2-449 

Confidential and Proprietary to The Ultimate Corp. 


SYS MON 


Available 


2-450 


072 number of times a virtual lock was requested, but 
unavailable 

073 number of successful dispatches 

074 number of dispatch attempts 

075 number of requests for I/O related kernel services 
076 number of requests for non-I/O related kernel services 
077 number of times system assigned a new execute level to 
a process 
078 reserved 
079 reserved 

Values in attributes 80 through 110 are for internal use only. 


On SYSPROG or SECURITY account on Ultimate S/370 and S/390 systems. 
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SYSPROG 

Syntax 

Description 
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SYSPROG displays the SYSPROG Main Menu. 


SYSPROG 


The SYSPROG Main Menu allows you to save files, back up accounts, 
load utility programs, set spooler parameters, reallocate files, and create 
boot tapes. 

Note: The SYSPROG command only works in the SYSPROG account. 
When invoked, SYSPROG displays the following menu: 


( 

SYSPROG MAIN 

MENU 

1. 

File-Save menu 


2. 

Account-Save menu 


3. 

Load Ulti's menu 


4 . 

Spooler Menu 


5. 

Automatic File Reallocation 

Menu 

6. 

Create Boot tape 



Press RETURN for TCL 


ENTER SELECTION ? 

_ ; _ ) 


At the Enter Selection prompt, enter the number of the desired option. 
The screen for the selected option is then displayed. 

To go back to TCL, press RETURN. 
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See Also 
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On SYSPROG account. 


ACCOUNT-SAVE 

ALL-UPDATE-SAVE 

CREATE-BOOT 

FILE-SAVE 

PART-UPDATE-SAVE 

REALLOCATE 

RESTORE-ALL-ULTIS 

SP-MENU 

ULTPMENU 

System Management Guide for information on the SYSPROG account 
and menus. 
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SYSTEM-ERROR-SUMMARY 

SYSTEM-ERROR-SUMMARY generates a summary of the SYSTEM- 
ERRORS file grouped by error type. 


Syntax system-error-summary 

Description SYSTEM-ERROR-SUMMARY can be used at any time, but is especially 

useful when troubleshooting suspected hardware problems. 

The report generated by SYSTEM-ERROR-SUMMARY is similar to that 
generated by LIST-SYSTEM-ERRORS when output is to the printer, 
although it does not print Group Format Errors (GFEs) or system aborts. 
If the SYSTEM-ERRORS file has no error items, the command displays 
the following message: 

[401] No items present. 

Up to five separate sections can be included in the report, depending on 
the errors present in SYSTEM-ERRORS: 

• ED AC (Error Detection And Correction) memory errors detected by 
the standard CPU. 

• MLCP (Multi-Line Communications Processor) errors. 

• EDAC errors detected by a disk controller. 

• Disk errors. 

• Machine check errors (Ultimate 1400 systems only). 

Errors within each section are sorted in chronological order. 

When SYSTEM-ERROR-SUMMARY is invoked, the following 
information is displayed: 

n items selected. 

Do you want the listing to the printer?(Y/<CR>) 

Enter Y to send the information to the printer, or press RETURN to 
display the information on the screen. 
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Available On sysprog account. 

See Also LIST-SYSTEM-ERRORS 
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SYSTEMERRORS 

SYSTEMERRORS lists the total number of errors recorded in the 
SYSTEM-ERRORS file over the past two days. 


Syntax systemerrors 

Description SYSTEMERRORS counts the errors logged in the SYSTEM-ERRORS file 
over the past two days. 

Note: For a complete listing of the errors, use LIST-SYSTEM- 
ERRORS. 

When SYSTEMERRORS is invoked, the following prompt is displayed: 

To Lineprinter (Y/N/X) 

To send the count of system errors to the printer, enter Y. To display 
the information on the screen, enter N. To return to TCL, enter X. 

:SYSTEMERRORSJ 

Count of System-Errors in the past 2 days 
To Lineprinter (Y/N/X) - NJ 

Total of SYSTEM ERRORS IN PAST TWO DAYS = 2 


Available On sysprog or security account. 

See Also list-system-errors 

SYSTEM-ERROR-SUMMARY 
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T-ATT 


/.^ 

'w 


T-ATT attaches a tape device to the line executing the command. 


Positional 

Syntax 

Keyword 

Syntax 


T-ATT {n} {size} {density} {(options)} 

T-ATT {DRIVE = n} 

{BLOCKSIZE = Size} 

{DENSITY = density} 

{SPEED = speed} 

{UNBUFFERED} 

{ASCII} / {EBCDIC} 

{DECFORM AT} 

{OLDLABEL} 

Note: If parameters are omitted, T-AIT attaches drive 0 with the 

current block size, or 8192 if no block size has been defined. 

T-ATT positional parameters and keywords are described below: 

Parameter Keyword Description 

n DRIVE = n Specifies the tape drive to be 

attached. A system can have up to 
four tape drives (0 to 3). 

size BLOCKSIZE = Specifies the size of the block to 

size write to tape, in the ranges shown 

below for each system. If omitted, 
the block size of the previous T-ATT 
command is used, or the default of 
8192 if no block size was 
previously specified. 

19 to 8192 lor 1/2" 
drives. 

256 to 4096 for 
cartridge drives, in 
increments of 256. 


Ultimate 

Bull 

6000/7000 
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Parameter Keyword 


density density = 
density 


Description 

Ultimate 19 to 8192. 

LSI 


Ultimate 

1400 


Ultimate 
S/370 and 
S/390 


19 to 32000 for 1/2" 
drives. 

512 to 31744 for 
cartridge drives, in 
increments of 512. 

19 to 32000. 


Specifies the tape density in bits per 
inch (bpi). Valid densities are 800, 
1600, and 6250, depending on the 
tape device. Tape must be at BOT 
for this command to take effect. 


SPEED = speed Specifies tape speed (25 or 100) for 
Pertec FS1000 tape drives only. 


UNBUFFERED For GCR tape drives only. Forces 
the drive to run in unbuffered mode 
to allow accurate tape error 
handling. Tape must be at BOT. 


The following parameters can be specified as either options or 
keywords. Options must include a left parenthesis. 

(Option Keyword Description 

A ASCII Specifies that reads and writes are in 

ASCII mode. This is the default. 


E EBCDIC Specifies that reads and writes are in 

EBCDIC mode. Translates to EBCDIC 
when writing to tape, translates from 
EBCDIC when reading from tape. This 
setting is in effect until a T-ATT (A or 
T-ATT ASCII command is executed. 
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(Option Keyword Description 

D DECFORMAT Specifies LSI 11 tape cartridge 

compatibility mode. It is used on 
Ultimate Bull 6000/7000 systems to 
read or write tape cartridges for use 
on LSI systems with tape cartridges. 
This compatibility mode supports the 
T-DUMP and ACCOUNT-SAVE 
commands. The data must be on the 
correct cartridge type for the drive 
doing the writing, but can be read by 
either drive type. 

O OLDLABEL Specifies old label format. Used for 

writing tapes to be read on Ultimate 
systems running Revision 122 and 
earlier operating systems. This entry 
is not necessary for reading tapes. 


On a multiple tape drive system, T-ATT must be used before any other 
tape command in order to attach a tape drive. You can attach only one 
tape drive to your line at a time. However, if a tape drive is already 
attached to your line, you can use T-ATT at any time to change the 
parameters. 

When there is only one tape drive connected to the system, most tape 
commands automatically attach the tape drive. However, you must use 
T-ATT before executing BASIC programs that do tape operations. 

Once attached, the tape drive remains unavailable to other lines until it is 
released by a T-DET command, or until the line logs off. The tape 
remains attached when you LOGTO another account 

If the specified tape drive is already attached to another line, the 
following message is displayed: 

Tape n attached to line nn 

If the line issuing the command is already attached to another tape drive, 
the following error message is displayed: 
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T-ATT 


Available 

See Also 

6985-3.2 


Cannot attach multiple tapes 

If your terminal is already attached to the specified drive, the command 
displays the current block size: 

Tape n attached 
Block size: nnnn 

If a new block size is specified in the command, the command replaces 
the old block size with the new block size, and displays the new block 
size. 


: T-ATTJ 

Tape 0 attached 
Block size: 8192 


Attach default tape 
drive 0, with default block 
size of 8192. 

:T-ATT DRIVE=3, 

Tape 3 attached 
Block size: 8192 

DENSITY=1600J 

Attach drive 3 with 
density of 1600. 

:T-ATT BLOCKSIZE 

= 16384J 

Attach drive 0 with 
blocksize of 16384. 

Tape 0 attached 
Block size: 16384 



:T-ATT UNBUFFERED 

Tape 0 attached 
Block size: 16384 

(AJ 

Attach GCR drive 0 in 
unbuffered mode with 
reads and writes in ASCII. 


On Any user account with privilege level 1 or greater. 


T-BCK T-DUMP 

T-CHK T-LOAD 

T-COPY T-RDLBL 

T-DET T-READ 

System Management Guide for information on tape read/write errors. 
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T-BCK 


T-BCK 


Syntax 


Description 


2-460 



T-BCK backspaces the tape a specified number of blocks, or to the 
previous end-of-file (EOF) mark or beginning-of-tape (BOT) mark. 


T-BCK {n} 

n Specifies the number of records to backspace. The 

maximum value is 2147483647. If omitted, the 
command backspaces to the position before the previous 
EOF, or to the BOT. 


T-BCK backs up the tape drive attached to the line executing the 
command. In a single drive system, T-BCK also does a T-ATT if 
necessary. In a multiple drive system, you must first attach the tape 
drive by entering T-ATT. 

T-BCK moves the tape back the specified number of records. If record 
number is omitted, the tape backs up until one of the following is 
reached: 

• The position immediately before the previous end-of-file (EOF) 
mark. If any further information is to be written to tape, you must 
enter T-FWD to position the tape just past the EOF mark. 

• The BOT mark. 

On LSI systems with cartridge tapes, the tape cannot be physically 
moved backwards except via the T-REW command. However, the cache 
memory buffer can contain records previously written to or read from 
the tape, and T-BCK may be able to back up within the buffer and enable 
you to T-READ the records in memory. 

On Ultimate 1400 systems, the cartridge tape drive has limited 
backspacing capability, and only supports the following T-BCK 
commands: 

• Use a T-BCK 1 command after reading a label (via T-RDLBL) to 
backspace over the label. 

• Use a T-BCK l command after reading a filemark or after a T-FWD 
command to backspace over the filemark. 
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T-BCK 


Available 

See Also 


• Use two T-BCK l commands after reading a label to backspace over 
both the label and the filemark. 

No other cases of T-BCK are supported on the Ultimate 1400 system 
cartridge tape drive. 


:T-BCK 12 J 

Go back 12 records. 

Block size: 8192 



On Any user account with privilege level 1 or greater. 


T-ATT 

T-FWD 

T-RDLBL 

T-READ 

T-REW 


6985-3.2 
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T-CHK 

Syntax 

Description 


Available On 

See Also 

2-462 


T-CHK checks one tape file or all tape files for unequal length errors and 
parity errors. 


T-CHK {(A} 

(A Checks all files on the tape. If omitted, only checks the 

file at the current tape location. 


Use T-CHK to check the current file or all files for parity errors. In a 
single drive system, T-CHK does a T-ATT if necessary. In a multiple 
drive system, you must first attach the tape drive by entering T-ATT. 

An unequal length error occurs when T-CHK reads a block that is not 
equal to the block size specified on the tape label. If an unequal length 
is found, T-CHK terminates with the following message: 

Unequal length error 


If the A option is omitted, the command returns to TCL after checking 
the current file and the following message is displayed: 

[91] End tape check - 1 file(s) 

If the A option is specified, the command starts at the current location 
and checks all files on the tape until it encounters an end-of-data (EOD) 
mark. The completion message indicates the number of files checked. 


:T-CHK (AJ 

Block size: 8192 

[91] End tape check - 61 file(s) 


Any user account with privilege level 1 or greater. 


T-ATT 

VERIFY-SAVE 
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T-COPY 


Syntax 


6985 - 3.2 


T-COPY allows systems with multiple tape drives to copy tape files from 
one tape to another. 


T-COPY drive#!,file#}{,newblksz) {(options) 

drive# Specifies the number (0-3) of the destination tape drive. 

This number must be different from the source tape drive 
number (the currently attached drive). 

file# Specifies the number of files to be copied. If omitted 

and the E option is not present, only the file at the current 
location is copied. 

Copies the files with a different block size than the block 
size on the original tape. If the destination drive is a 
Ultimate 1400 system cartridge tape drive, newblksz is 
forced to a multiple of 512. 

Copies all files until the end-of-data (EOD) mark is 
reached. 

I Inhibits ANSI minimum record lengths of 19 bytes. 

L Displays Ultimate tape labels on the terminal as they are 

encountered. This option must be used when copying to 
quarter-inch cartridge tapes on Ultimate 1400 systems. 
The L option is required when copying tapes from a 
multiple-reel set. 

R Reverses the source drive and destination drive. That is, 

the currently attached tape drive becomes the destination 
drive and the drive specified by T-COPY becomes the 
source drive. 

S Swaps even/odd bytes. The is useful when 

interchanging tapes with certain non-Ultimate equipment. 

U Rewinds and unloads the destination tape drive when the 

copy is complete. 


newblksz 

(options 

E 
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T-COPY 


Description 


2-464 


T-COPY is available on systems with multiple tape drives. The command 
assumes that the source drive is loaded with the tape to be copied, and 
the drive is attached. 

Any tape drive can be used as the source or destination, but the same 
drive cannot be used for both. If the source and destination tapes are 
mistakenly assigned to the same drive, the following error message is 
displayed: 

From/To cannot be same drive. 

Unless the R option is used, the source drive is the tape drive currently 
attached with T-ATT. 

If the destination drive does not exist, the following message is 
displayed: 

No such tape unit. 

If the destination tape drive is attached to another line, the following 
message is displayed: 

Tape n attached to line nn 


If a new block size is omitted, the command copies data blocks with the 
same block size to the destination drive. If the tape on the source drive 
has variable-sized block data, the same variable-sized block data is 
copied to the destination drive. 

If the new block size is larger than the block size on the source tape 
drive, data is packed into the larger block for the destination drive. For 
example, to copy from block size 2000 to 4000, two data blocks from 
the source drive are packed into one data block for the destination drive. 

On the other hand, if the new block size is smaller than the block size in 
the source drive, data is unpacked into smaller blocks for the destination 
drive. For example, to copy from block size 4000 to 2000, one source 
data block is unpacked into two data blocks for the destination drive. 

When an end-of-file (EOF) mark is reached on the source drive, the data 
block for the destination drive can be partially full due to packing or 
unpacking. In this case, the remainder of the block is filled with X'FB'. 
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T-COPY 


Available 

See Also 

6985-3.2 


If the system tries to copy a block that is less than the ANSI minimum 
size of 19 bytes (or less than 1 byte if the I option is used), the 
following message is displayed: 

Invalid size - block skipped 


When copying half-inch tapes to Ultimate 1400 system quarter-inch 
cartridge tapes, you must use the L option. The L option forces the 
copy block size to be a multiple of 512, which is a requirement of the 
Ultimate 1400 quarter-inch cartridge tape drive. 

Always use the L option when copying tapes from a multiple-reel set. 
Without the L option, the end-of-reel label from the source tape can be 
copied onto the middle of the destination tape. If this end-of-reel label is 
found during a restore, the system prompts you to load the next reel, 
even though there may still be data after the label. 

The L option also correctly numbers the copies of a multiple-reel set. 
Without this option, the tapes may not be numbered properly. 

When copying without the E (EOD) option, you should normally follow 
the T-COPY with an attach of the destination drive and T-WEOF. 


: T-COPY 1,,8192 (EJ 

:T-COPY 1, 3,8192 (LJ 


Copy all files to tape drive 1, with 
blocksize 8192. 

Copy 3 files to drive 1 (1400 1/4 
cartridge tape drive), with 
blocksize 8192. 


On SYSPROG or SECURITY account. 


T-ATT 

T-READ 
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T-DET 


T-DET 


Syntax 


Description 


T-DET detaches a tape drive from a line. 


T-DET {U} {drive#} 

U Unconditionally detaches the specified drive; available 

only to users with privilege level 2. If drive number is 
omitted, tape drive 0 is detached. This option cannot be 
used to detach the tape drive used by the transaction 
logger. 

drive# Specifies the number of the tape drive to be detached. If 

omitted, the tape drive attached to the current line is 
assumed. 


Use T-DET to detach a tape drive from a line. When a drive has been 
detached, it becomes available to other users to attach via T-ATT. 

You do not need to use T-DET when you log off, since these devices are 
automatically detached when you log off the line. 

If no drive is currently attached, the command returns the following 
error message: 

No tape attached! 

If you want to detach the drive on which the transaction logger is 
currently running, you must suspend the tape (from the Log Menu) 
before using T-DET U. T-DET U then verifies that the transaction logger 
tape has been suspended. Otherwise, it does not detach the tape drive. 

If you enter T-DET U for a drive that is in use by another process, T-DET 
fails and the following message is displayed: 

Detach request denied 
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6985 - 3.2 


T-DET 


Available 


See Also 


6985 - 3.2 


:T-DET U 2J 

Detach tape drive 2 from the line 


to which it is attached. 


On Any user account to detach a tape drive from the current line. Must have 
privilege level 2 to detach a tape drive from another line. 


T-ATT 
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T-DUMP 


T-DUMP 


Syntax 


Description 


Available On 


2-468 


T-DUMP is an Ultimate RECALL command that dumps the contents of a 
specified file from disk to tape. 


T-DUMP filename {itemlist} {sel-criteria} {HEADER "name"} 
{(options) 


filename 

itemlist 


sel-criteria 


Specifies the file to be dumped to tape. 

Specifies one or more explicit item-lDs. If 
specified, each item-ID must be enclosed in single 
quotes, double quotes, or backslashes. If 
omitted, the command acts on the current select- 
list, or on all items in the file if no select-list is 
present. 

Conditions that must be met by an item in order 
for it to be dumped. Also known as a WITH 
clause. 


HEADER "name" Specifies a tape label "name." 

(options 

D LSI 1 .! tape compatibility. 

H Suppresses the tape label. 

I Suppresses listing dumped items to the terminal. 


For further information on T-DUMP, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 


Any user account. 
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T-EOD 

Syntax 

Description 


Available On 

See Also 


6985-3.2 


T-EOD moves the tape forward until it reaches the end-of-data (EOD) 
mark. 


T-EOD 


T-EOD moves the tape attached to the current line forward to the end-of- 
data (EOD) mark. The EOD mark is a double end-of-file (EOF) mark and 
is expected after the last file on the tape. The tape will be positioned 
between these two file marks. 

Use T-EOD before appending data to the end of a tape with existing data. 
For example, to add a file to the end of a tape, enter a T-EOD followed 
by a T-DUMP. 

Note: You cannot append data to the end of an Ultimate 1400 system 
cartridge tape. 


: T-EOD 

Block size: 8192 
[91] End tape check - 3 file(s) 


Any user account with privilege level 1 or greater. 


T-BCK 

T-DUMP 

T-FWD 
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T-ERASE 


T-ERASE 

Syntax 

Description 


Available On 


2-470 


W 


T-ERASE erases tape. 


T-ERASE 


Use T-ERASE to create gaps in a tape. 

On Ultimate Bull 6000/7000 systems and LSI systems, T-ERASE erases a 
2-inch section of the tape attached to the current line. T-ERASE starts 
erasing at the current position of the tape and erases forward 2 inches. 

On Ultimate S/370 and S/390 systems, T-ERASE erases up to a 2 feet 
section of the tape. 

On Ultimate 1400 systems, T-ERASE erases the entire tape. 


Any user account with privilege level 1 or greater. 
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T-FWD 

Syntax 


Description 


Available On 

See Also 


T-FWD moves a tape forward a specified number of records, or to the 
next end-of-file (EOF) mark. 


T-FWD {n} 

n Specifies the number of records to move forward. The 

maximum number is 2147483647. If omitted, the tape 
moves forward to the position immediately after the next 
EOF mark. 

Note: T-FWD n to move n number of records forward is not 

supported on Ultimate 1400 systems; but T-FWD to move to 
the next EOF mark is supported. 


T-FWD moves the attached tape forward the specified number of records, 
or to the position immediately after the next EOF mark. The tape is then 
ready to read the first record of the next file. 


:T-FWD 

3 J 

Move forward 3 records. 

Block 

size: 8192 


End of 

file 



Any user account with privilege level 1 or greater. 


T-BCK 

T-EOD 

T-SPACE 
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T-LOAD 


T-LOAD 


Syntax 


Description 


Available On 


2-472 




T-LOAD is an Ultimate RECALL command that loads specified file items 
from the tape attached to the current line. 


T-LOAD filename {itemlist} {sel-criteria} {(options} 


filename Specifies the file containing items to be loaded from tape. 

itemlist Specifies one or more explicit item-lDs. If specified, 
each item-ID must be enclosed in single quotes, double 
quotes, or backslashes. If omitted, the command acts on 
the current select-list, or on all items in the file if no 
select-list is present. 


sel-criteria Conditions that must be met by an item in order for it to 
be loaded. Also known as a WITH clause. 

(options 


I Suppresses listing dumped items to the terminal. 

() Overwrites existing items. 


For further information on T-LOAD, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 


Any user account. 
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T-RDLBL 


T-RDLBL 

Syntax 

Description 


6985-3.2 


T-RDLBL reads and displays a tape label. 


T-RDLBL 


Use T-RDLBL to read and display a tape label. On single drive systems, 
T-RDLBL performs an automatic T-ATT if necessary. On multiple drive 
systems, a T-ATT must first be used to attach the desired drive. The tape 
must be positioned before the label at the beginning of a tape file. 

Labels are automatically written at the beginning of tape files created by 
T-DUMP, and before each account saved by a file-save command such as 
FILE-SAVE and ACCOUNT-SAVE. Labels can also be written by T- 
WTLBL. 

If no tape label exists on the tape, or is not in the standard label format, 
or if the tape is not positioned before the label, the command reads the 
first tape record, determines the tape does not contain a label, and backs 
up one record. 

Tape label format is: 

L rrrrlhh:mm:ss dd mon yyyy filename A nn 
where: 

L Label specifier (in byte 1). 

rrrr Block size in hexadecimal. 

h h: mm: ss Time the label was written. 

dd mon yyyy Date the label was written. 

filename Source filename. It can be user-specified if T- 

WTLBL was used instead of T-DUMP. 

A nn Attribute mark ( A ) in byte 78 followed by the reel 

number in bytes 79 and 80. Depending on your 
terminal, the attribute mark may be displayed 
with another symbol. 
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T-RDLBL 


Available 

See Also 


Note: On multiple-reel tape files, bytes 1-77 are the same on-each- 
tape label. 

: t-rdlblj Read the next tape label. 

Block size: 4000 

L 01B7#09:25:30 20 MAR 1991 PAYROLL ABC CORP. *01 


On Any user account with privilege level 1 or greater. 


T-DUMP 

T-WTLBL 
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T-READ 


T-READ 


Syntax 


Description 


T-READ displays or prints the contents of the attached tape. 


T-READ {n{-m}} {(options} 

n Displays tape blocks 1 through n. If omitted, all tape 

blocks to end-of-file (EOF) or end-of-data (EOD) are 
displayed. 

n-m Displays tape blocks n through m. If omitted, all tape 

blocks to end-of-file (EOF) or end-of-data (EOD) are 
displayed. 

(options 

A Converts data from EBCDIC to ASCII and outputs that 

data in ASCII character format. 

I Inhibits ANSI minimum record length restriction of 19 

bytes. 

N Specifies no automatic end-of-page waiting. 

P Routes output to the spooler. 

S Swaps even/odd bytes. This is useful when reading 

certain non-Ultimate tapes. 

X Outputs all data in hexadecimal and character format. 

Note: If parameters are omitted, all records in the current file on the 
tape are displayed in ASCII character format. 


Use T-READ to check the contents of a tape or tape file. On single drive 
systems, T-READ performs an automatic T-ATT if necessary. On 
multiple drive systems, a T-ATT must first be used to attach the desired 
drive. 

T-READ outputs the tape label (if present and in standard format), and 
then displays the rest of the tape data. This is useful for finding the 
location of a specific file. 


6985-3.2 
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THREAD 


2-476 


T-READ starts reading at the current tape location, and stops when the 
specified number of blocks have been output, or when an end-of-file 
(EOF) mark is reached. 


Each block displayed is preceded by a record counter (RECORD = n). 
The last block may be padded after the end of valid data. T-DUMP pads 
with SB characters (X’FB'), which print as a left bracket ([). File-save 
commands, such as FILE-SAVE and ACCOUNT-SAVE, and BASIC pad 
with blanks. 


If the system tries to read a block that is less than the ANSI minimum size 
of 19 bytes (or less than 1 byte if the I option is used), the following 
message is displayed: 


Invalid size - block skipped 


: t -read j Display in character format. 

RECORD = 1 

1 FORMATC********************************* ********** 
51 ****************** THIS PROGRAM FORMATS A BASIC PR 
101 OGRAM TO[* DISPLAY BLOCK STRUCTURING BY INDENTING 
151 LINES ******************************************** 


RECORD = 2 

1 SPX = SP LINE.NO = 0*—[--INPUT FILE NAME AND 
51 PROGRAM NAME PRINT PRINT PRIN 

101 T BASIC FILE NAME - INPUT FI[LE UNTIL FILE 
151 ='' DO OPEN 


401 [[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[ 
451 [[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[ 

[94] END OF FILE 
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T-READ 


Available 

See Also 


:T-READ XJ 

RECORD = 1 



Display in hexadecimal format. 

0000 

0010 

4 64F524D 

242A2A2A 

415443FE 

242A2A2A 

2A2A2A2A 

24 2A2A2A 

2A2A2A2A 

242A2A2A 

0:FORMATC* ** * * * * * : 

01C0 

01D0 

01E0 

01F0 

20202020 

20202020 

2 030FE2A 

2046494C 

20535058 

2020204C 

2D2DFFFB 

203D2053 

4 94E452E 

2D2D204 9 

50FE2020 

4E4F203D 

4E505554 

448: SPX = SP" : 

464: LINE.NO = : 

480 : 0"* — [ — INPUT: 

496: FIL: 

RECORD = 2 





0000 

0010 

4 5204E41 

52414D20 

4D452041 

4E414D45 

4E442020 

FE20202 0 

5052 4 F4 7 

20202020 

0 : E NAME AND PROG: 

16:RAM NAME" : 

01E0 

01F0 

FBFBFBFB 

FBFBFBFB 

FBFBFBFB 

FBFBFBFB 

FBFBFBFB 

480: [[[[[[[[[[[[[[: 

496: [ [[[: 

[94] 

END OF FILE 





On Any user account with privilege level 1 or greater. 


T-ATT 

T-RDLBL 

T-WTLBL 
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T-RET 


T-RET 


Syntax 


Description 


Available On 


See Also 


2-478 


T-RET retensions a quarter-inch cartridge tape. 


T-RET {n} 

n Specifies the number of times to retension the tape. If 

omitted, the tape is retensioned once. 


Retensioning is recommended if a cartridge tape has been sitting unused 
in a drive for several hours. This procedure can also be helpful if you 
are having trouble reading a tape cartridge. For best results, repeat the 
retensioning several times. 

T-RET moves the tape forward to the end-of-tape mark and then rewinds 
it back to the beginning of the tape. The tape is then brought to load 


point. 

:T-RET 

3 J 

Block 

size: 4000 


Any user account with privilege level 1 or greater on systems with 
quarter-inch cartridge tape drives. 


T-ATT 

T-BCK 

T-FWD 
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T-REW 

Syntax 

Description 


Available On 

See Also 

6985-3.2 


T-REW rewinds the tape attached to the current line. 


T-REW 


T-REW rewinds the tape attached to the current line to the load point. 

The rewind begins at the current tape location and stops when it reaches 
the beginning-of-tape (BOT) mark. 

On Ultimate 1400 systems with tape cartridges, T-REW should always 
be performed before any sequence that will read or write data to a tape 
that has just been loaded or manually removed. 

A T-REW (or a T-UNLOAD) should also be performed before a tape is 
removed from the drive on an Ultimate 1400 system tape cartridge, or 
Ultimate LSI system cartridge. Failure to execute a T-REW or T-UNLOAD 
after writing to the tape means the tape will not have a valid end-of-data 
(EOD) mark. 


:T-REWJ 

Block size: 4000 
Rewinding... 


Any user account with privilege level 1 or greater. 


T-ATT 

T-BCK 

T-FWD 

T-DET 

T-UNLOAD 
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T-SPACE 


T-SPACE 

Syntax 

Description 


Available On 

See Also 

2-480 


u 

T-SPACE moves the attached tape drive forward a specified number of 
files, or until the end-of-data (EOD) mark. 


T-SPACE {n} 

n Specifies the number of files to move forward. If 

omitted, the system prompts for it. 

Use T-SPACE to quickly position the tape at the beginning of a specific 
file. T-SPACE is a PROC composed of the commands T-RDLBL and T- 
FWD. 




: t-space 2 J Move forward 2 files. 

Block size: 8192 

Write density set to 1600 bpi 

L OFAO#21:50:02 30 MAR 1991 DATA SYSLIB -01 

Block size: 8192 
Write density set to 1600 bpi 
End of file 
Block size: 8192 
Write density set to 1600 bpi 

L 0FA0#21:50:02 30 MAR 1991 DATA ERRMSG -01 

Block size: 8192 
Write density set to 1600 bpi 
End of file 
Block size: 8192 
Write density set to 1600 bpi 


Any user account with privilege level 1 or greater. 


T-ATT 

T-DET 

T-FWD 

T-RDLBL 
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T-STATUS 

Syntax 

Description 


6985-3.2 


T-STATUS displays the current status of all tape drives on the system. 


T-STATUS 


T-STATUS determines the status of all system tape drives and displays 
the report on the terminal. 

If the tape drive is attached to the line issuing the command, and is 
capable of density selection (GCR, Pertec FS1000 and FS2000 on the 
Ultimate Bull 6000/7000), or the DENSITY keyword was used with the 
T-ATT command on the IBM, the following T-STATUS message is 
displayed: 

Tape n is attached to your line, status, write density 
is xxx, write 


where: 

status Off-line or on-line. 

xxx Density specified with DENSITY keyword, 

write Write-protected or write-permit. 

If the drive is not capable of density selection, then the following T- 
STATUS message is displayed: 

Tape n is attached to your line, status, write 

If the tape is attached to another line, the following message is 
displayed: 

Tape n attached to line m 

If the tape is not attached, the following message is displayed: 

Tape n not attached 
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T-STATUS 


Available 

See Also 


2-482 


: T-STATUSJ 

Tape 0 is attached to your line, on-line, write density 
is 1600, write protected. 

Tape 1 attached to line # 0 


On Any user account with privilege level 1 or greater. 


T-ATT 

T-DET 
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T-UNLOAD 

Syntax 

Description 


Available On 

See Also 


6985-3.2 


T-UNLOAD rewinds the attached tape and unloads the tape device. 


T-UNLOAD 


T-UNLOAD is an alternative to T-REW to rewind a tape. It rewinds the 
tape to load point (BOT) and unloads it for removal. 

Note: A T-UNLOAD (or T-REW) should be performed before removing 
a tape from an Ultimate 1400 system tape cartridge. Failure to 
execute a T-REW or T-UNLOAD after writing to the tape means 
the tape will not have a valid EOD mark. 

When specified for a cartridge drive (Ultimate Bull 6000/7000 system. 
Ultimate LSI system, and the Ultimate 1400 system), T-UNLOAD is 
treated as a T-REW. 


: T-UNLOADJ 

Rewind and unload the tape 

Block size: 8192 

attached to the current line. 

Rewinding... 



Any user account with privilege level 1 or greater. 


T-ATT 

T-BCK 

T-DET 

T-FWD 

T-REW 

T-WEOF 
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T-WEOF 

Syntax 

Description 


2-484 


T-WEOF writes an end-of-file (EOF) mark on the tape attached to the 
current line. 


T-WEOF 


T-WEOF writes the EOF mark at the current tape position. The EOF mark 
is actually written twice and the tape is backed up over the second mark. 
The two EOFs together create an end-of-data (EOD) mark. If additional 
data is then written on the tape, the second EOF is overwritten, resulting 
in a normal EOF between files. If no additional data is written, the EOD 
effectively marks the end of valid data on the tape. 

Note that T-WEOF is not necessary after most tape operations, because T- 
DUMP, T-COPY without the E option, and file-save commands 
automatically add an EOD after writing the last tape record. BASIC, 
however, does not add the EOD mark. 

Since the Ultimate 1400 system and Ultimate LSI system tape cartridge 
drives are not capable of backspacing, the second filemark is not 
immediately written for these drives. If T-WEOF is followed by a 
command that writes more data to the tape, such as T-Dl imp, then the 
second filemark is not written at all. If T-WEOF is followed by a T-REW 
or a T-UNLOAD, the second filemark is written and the tape is rewound. 

For this reason a T-REW or T-UNLOAD must be executed after writing 
data to the tape and before removing the tape cartridge. Failure to 
execute a T-REW or T-UNLOAD after writing to the tape means the tape 
will not have a valid EOD mark. 


Ultimate System Commands Guide 6985-3.2 

Confidential and Proprietary to The Ultimate Corp. 




T-WEOF 


Available 

See Also 


:T-WEOFJ 

Write an EOF mark at the 

Block size: 4000 

End of file 

current tape location. 


On Any user account with privilege level 1 or greater. 


T-ATT 

T-DET 

T-DUMP 

T-EOD 
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T-WTLBL 


Syntax 


Description 


2-486 


T-WTLBL writes a tape label at the current tape location. 


T-WTLBL label 

label Specifies the label data (from 1 to 48 characters) to be 

written to the tape. This data normally includes file and 
header identifiers. If omitted, T-WTLBL does not write 
anything on the tape. 


T-WTLBL must be used when writing from a BASIC program to tape if a 
tape label needs to be generated. Although the BASIC program must 
include WRITET commands to write data records to tape, it does not 
write labels. T-WTLBL must be used for this, either before running the 
program, or from within the program via an EXECUTE statement. 


T-WTLBL can also be used any other time a tape label needs to be 
written. The command assumes that the tape is positioned at the load 
point, or after an end-of-file (EOF) mark. The label is 80 bytes in 
length, and contains the elements shown below: 


L rrrr#hh:mm:ss dd mon yyyy label A nn 

where: 


L 

rrrr 

hh:mm:ss 
dd mon yyyy 
label 


'nn 


Label specifier (in byte 1). 

Block size in hexadecimal. 

Time the label was written. 

Date the label was written. 

User specified label, up to 48 characters. 

Attribute mark ( A ) in byte 78 followed by the reel 
number in bytes 79 and 80. Depending on your 
terminal, the attribute mark may be displayed 
with another symbol. 


Note: On multiple-reel tape files, bytes 1-77 should be the same on 

each tape label. 
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Available On 

See Also 


6985-3.2 


: T-WTLBL PAYROLL DATA FOR ABC CORP . J 

Block size: 8192 

L 01B7#09:25:30 20 MAR 1991 PAYROLL DATA FOR ABC CORP. ~01 


Any user account with privilege level 1 or greater. 


RUN 

T-ATT 

T-DET 

T-RDLBL 

Ultimate BASIC Language Reference Guide. 
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TABS 


Syntax 


Description 
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TABS sets tab stops for terminal input or output. 


{I/O {S} } 

(I/O {nl {,n2,n3 ...nl5}}} 

Indicates input tab stops or output tab stops, 
respectively. 

S When used with the I or O option, reinstates the 

most recently set tab stops (either input or 
output). 

nl {,n2,n3...} Specifies column position(s). When used with 
the I or O option, the specified tab stops are set at 
the n positions or columns. Up to 15 tab stop 
positions can be specified. They must be in 
ascending numerical sequence. 

Note: If parameters are omitted, the current input and output tab 
stops are displayed. 


TABS 

TABS 

I or O 


Tabs are stops for user input from the terminal, and for system¬ 
generated output to the terminal. TABS can be used for a variety of tab 
stop operations: 

« Display the current tab stops. 

• Reinstate or disable previously set tab stops. 

• Set new tab stops. Tab stops can be set for input or output 
functions, but a separate TABS is needed for each function. 

Note: BASIC, PROC, and the Ultimate Line Editor support tabs; TCL 

supports tabs only when the TCL stack is ON. 

When TABS is invoked with no parameters, the currently set tab stops (if 
any) are displayed as follows: 


Ultimate System Commands Guide 6985 - 3.2 

Confidential and Proprietary to The Ultimate Corp. 


TABS 


1 2 3 4 5 . . . 

12345678901234567890123456789012345678901234567890123 . . . 
I I I I I I I 
OOOOO 

where I marks the columns where an input tab stop occurs, and O marks 
the columns where an output tab stop occurs. 

If TABS is invoked with parameters, the first parameter must be either an 
I or an O. If other parameters are omitted, all tab stops of the specified 
type (input or output) are cleared. 

If the S parameter is entered, all tab stops of the specified type (input or 
output) are reinstated to their last known positions and become 
operative. 

If one or more numbers is specified, each number represents a column 
where a tab stop is to be set. Any existing tab stops are cleared before 
new ones are set. 

Once a set of tab stops has been established, they become available at 
any time the system performs input/output on the terminal. The input 
tabs control the spacing available via the TAB key (on some terminals, 
this is <CTRL-I>). That is, when the TAB key is pressed, spaces are 
output until the cursor reaches the next tab stop. If no more tab stops 
are set, the TAB key has no action. 

In order to perform a tab operation, the system looks only for the 
hexadecimal character X'09', whether or not the TAB key input it. 

Note: Input tabs set by TABS I are identical to those set by TB in the 
line editor. 

Output tabs are only useful for those printing terminals that support 
physical tabbing, and can be used to speed up output on printing 
terminals. Output tabs are not normally required nor advantageous on 
CRTs, since CRTs print blanks quickly, and output tab stops may not be 
supported or may be awkward to set. 

If output tab stops are set, the system replaces blank sequences in any 
output generated by the system with an appropriate tab character 
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TABS 


Available 


2-490 


(<CTRL-I>), thus reducing the data output. The user must also set up 
the physical tab stops on the terminal to correspond to those set in the 
TABS O statement. On many terminals, this entails positioning the 
carriage and entering a set-tabs sequence from the keyboard. 


:TABS I 

4,8,12, 16, 20,24,28J 

Set input tabs at the 
indicated columns. 

.-TABS 0 

10,20,30,40,50,60J 

Set output tabs at the 
indicated columns. 

:TABS J 


Display the current tab 
settings. 

:TABS IJ 


Remove all input tab 
stops. 

:TABS 0 

SJ 

Reinstate all output tab 
stops. 


On Any user account. 
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TAPE.DIAGS 


TAPE.DIAGS is used by the ON-LINE-DIAGS command to test tape drive 
operation. 

For complete information on TAPE.DIAGS, refer to the ON-LINE-DIAGS 
command. 
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TCL-PROMPT 


TCL-PROMPT 


Syntax 


TCL-PROMPT changes the TCL prompt for the current line. 


TCL-PROMPT {text} {'sys.code'} {<S>(c,r)} (@{-n)} 

text Specifies any string to be displayed, up to 39 characters. 


'sys.code' 

A 

D 

E 


L 

M 


N 

P 

R 


Displays system information; must be enclosed in single 
quotes. One or more of the following system codes can 
be specified: 

Account name. 

Date in dd mon yyyy format. 

TCL stack entry number of the command that is currently 
displayed. 

TCL execute level. 

Machine type code to indicate the current system. 
Possible codes include: 

DO LSI system without typeahead. 

D 1 LSI system with typeahead and regular memory. 

0 2 LSI system with typeahead and regular memory. 

D 3 LSI 3030 system. 

D 4 LSI 3040/3050 system. 

H1 Ultimate HPP system. 

H2 Ultimate Bull 7000 system. 

H3 Ultimate Bull 8Mb 6000 system. 

IN IBM native system. 

IV IBM system under VM. 

MO Ultimate 1400 system. 

UltiNet node name. 

Line number. 

Revision of operating system ABS. 
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TCL-PROMPT 


Description 


6985 - 3.2 


S System serial number. 

T System time. 

Xnn Hexadecimal value. 

<®(c,r) Positions cursor at column c, row r. 

@(-n) Generates a terminal escape sequence for visual 

attributes; see Table 2-1 for values and descriptions. 
These are the same values that are available in the BASIC 
@(-n) functions. Although any can be specified, not all 
may be meaningful for TCL-PROMPT. Ultimate 
recommends that you not use those codes marked with 
an asterisk (*). 

Note: If parameters are omitted, the current TCL prompt is displayed. 


The parameters can be specified in any order and are displayed in the 
order in which they are specified. 

The prompt set for the current line remains in effect when you log to 
another account, unless the logon PROC in that account changes it. If 
the current account name (A code) is part of the prompt, the prompt 
changes to the new name when you log to another account. 

If TCL-PROMPT is in effect, secondary TCL levels are not indicated with 
a double prompt, although the L parameter can be used to display the 
current execute level. 

The specified prompt remains until one of the following occurs: 

• You log off. 

• Another TCL-PROMPT is issued. 

• TCL-PROMPT-OFF is issued. 

The prompts displayed by the system debugger (!) and the BASIC 
debugger (*) are not affected by this command. 
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- - r 

f / 

\ 

Note: In order to avoid confusion with other prompts, or other 

system problems, Ultimate recommends that you not use the 
following characters in your prompt string: 

! System debugger prompt 

* BASIC debugger prompt 

& Displays disk errors 

% Displays tape errors 

@ DEC kernel prompt 

A= Honeywell kernel prompt 


: TCL-PROMPT + J 

+ 

Sets prompt character to +. 

:TCL-PROMPT ' P A'-J 

009 DEV- 

Sets prompt character to current 
line number and account name, 
followed by dash. 

009 DEV-LOGTO PRODUCTIONJ 

009 PRODUCTION- 

Sets prompt to logged-to account 
name. 

:TCL-PROMPT @ ( - 5 ) ? @ ( - 6 ) J 

7 

Sets prompt character to 
blinking question mark. 

: TCL-PROMPT ' X1B ' F ' TX0D ' J 

On a Wyse 50 terminal, the 
time is displayed on the status line 
and a colon ts displayed on the 
prompt line. The time is updated 
every time the TCL prompt is 
redisplayed. 
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Table 2-1. Cursor Control Values (1 of 6) 


Code 

Description 

@(-l) 

Clear the screen and position the cursor at 'home' 
(upper left corner of the screen). 

@(-2) 

Position the cursor at 'home' (upper left corner). 

@(-3) 

Clear from cursor position to the end of the screen. 

@(-4) 

Clear from cursor position to the end of the line. 

@(-5) 

Start blink. 

@(-6) 

Stop blink. 

@(-7) 

Start dim. 

@(-8) 

Stop dim. 

@(-9) 

Backspace the cursor one character. 

@(-10) 

Move the cursor up one line. 

@(-H) 

Move the cursor down one line. 

@(-12) 

Move the cursor right one column. 

@(-13)* 

Enable auxiliary (slave) line. 

@(-14)* 

Disable auxiliary (slave) line. 

@(-15)* 

Enable auxiliary (slave) line in transparent mode. 

@(-16)* 

Initiate slave local print. 

@(-17) 

Start underline. 

@(-18) 

Stop underline. 

@(-19) 

Start reverse video. 

@(-20) 

Stop reverse video. 

@(-21) 

Delete line. 

@(-22) 

Insert line. 

@(-23) 

Scroll screen display up one line. 

@(-24) 

Start boldface type. 

@(-25) 

Stop boldface type. 


* Ultimate recommends that you not use this code. 
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Table 2-1. Cursor Control Values (2 of 6) 


S~\ 


Code 

@(-26) 

@(-27) 

@(-28)* 

@(-29)* 

@(-30,c) 


Description 

Delete one character. 

Insert one blank character. 

Start insert character mode. 

Stop insert character mode. 

Set foreground and background color: 


c 

1 

background 

black 

foreground 

cyan 

2 

black 

red 

3 

black 

blue 

4 

black 

green 

5 

black 

magenta 

6 

black 

yellow 

7 

black 

white 

8 

blue 

red 

9 

blue 

green 

10 

blue 

white 

11 

blue 

yellow 

12 

blue 

red 

13 

blue 

cyan 

14 

blue 

mo I'tan 

1 I 

15 

white 

red 

16 

white 

green 

17 

white 

blue 

18 

white 

cyan 

19 

white 

magenta 

20 

white 

black 

21 

red 

white 

22 

red 

green 


* Ultimate recommends that you not use this code. 
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Table 2-1. Cursor Control Values (3 of 6) 


Code 

Description 

@(-31,0 

Set foreground color: 



f 

foreground 



1 

brown 

(may vary on some 
terminals) 


2 

white 



3 

red 



4 

magenta 



5 

yellow 



6 

green 



7 

cyan 



8 

blue 


@(-32,b) 

Set background color: 



b 

background 



1 

brown 



2 

white 



3 

black 



4 

red 



5 

blue 



6 

cyan 



7 

magenta 


@(-33) 

Set 80 columns 


@(-34) 

Set 132 columns 


@(-35) 

Set 24 rows 


@(-36) 

Set 44 rows 


@(-37)- 

@(-45)* 

Reserved 




* Ultimate recommends that you not use these codes. 


Ultimate System Commands Guide 2-497 

Confidential and Proprietary to The Ultimate Corp. 



TCL-PROMPT 


2-498 


Table 2-1* Cursor Control Values (4 of 6) 


Code 

Description 

@(-46)* 

Returns function key default values as a string in the 
following format: 



SFBfFBx 1 FA... x lbFBy 1 FA.. .y 1 6FBeFB 


s 

character sequence needed to set the overall 
characteristics of the function line; typically, 
this is null 


f 

lead-in sequence used to load function keys 


xn 

value for function key n 


yn 

value for shifted function key n 


e 

terminator for key text 

@(-47)* 

Returns character sequence needed to set the overall 
characteristics for the label line (bottom line of 
terminal). The following information is returned: 



sFBfFBxFByFBeFBr 


s 

character sequence needed to set the overall 
characteristics of the label line 


f 

lead-in sequence used for label line 


xn 

lead-in sequence for unshifted label line 


yn 

lead-in sequence for shifted label line 


c 

terminator for text 


r 

reset label line (turn off) 

@(-48)* 

Returns character sequence needed to set the overall 
characteristics for the status line (top line of 
terminal). The following information is returned: 



SFBfFBxFByFBeFBr 


s 

character sequence needed to set the overall 
characteristics of the status line 


f 

lead-in sequence used for status line 


xn 

lead-in sequence for unshifted status line 


yn 

lead-in sequence for shifted status line 


e 

terminator for text 


r 

reset status line (turn off) 


* Ultimate recommends that you not use this code. 
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Table 2-1. Cursor Control Values (5 of 6) 


Code 

Description 

@(-49)* 

Return string that defines the graphics characters set; 
the exact characters that will be displayed depend on 
the terminal type. 

@(-50)* 

Start graphics. 

@(-51)* 

Stop graphics. 

@(-52) 

Start blink. 

@(-53) 

Stop blink. 

@(-54) 

Start reverse video. 

@(-55) 

Stop reverse video. 

@(-56) 

Start reverse video and blink. 

@(-57) 

Stop reverse video and blink. 

@(-58) 

Start underscore. 

@(-59) 

Stop underscore. 

@(-60) 

Start underscore and blink. 

@(-61) 

Stop underscore and blink. 

@(-62) 

Start underscore and reverse video. 

@(-63) 

Stop underscore and reverse video. 

@(-64) 

Start underscore, reverse video, and blink. 

@(-65) 

Stop underscore, reverse video, and blink. 

@(-66) 

Start dim. 

@(-67) 

Stop dim. 

@(-68) 

Start dim and blink. 

@(-69) 

Stop dim and blink. 


* Ultimate recommends that you not use this code. 
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Table 2-1. Cursor Control Values (6 of 6) 


Code 

Description 

@(-70) 

Start dim and reverse video. 

@(-71) 

Stop dim and reverse video. 

@(-72) 

Start dim, reverse video, and blink. 

@(-73) 

Stop dim, reverse video, and blink. 

@(-74) 

Start dim and underscore. 

@(-75) 

Stop dim and underscore. 

@(-76) 

Start dim, underscore, and blink. 

@(-77) 

Stop dim, underscore, and blink. 

@(-78) 

Start dim, reverse video, and underscore. 

@(-79) 

Stop dim, reverse video, and underscore. 

@(-80) 

Set 80 columns. 

@(-81)* 

Reserved. 

@(-82) 

Set 132 columns. 


* Ultimate recommends that you not use this code. 
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TCL-PROMPT-OFF 


TCL-PROMPT-OFF resets the TCL prompt. 


Syntax tcl-prompt-off 


Description TCL-PROMPT-OFF resets the TCL prompt (if the TCL stacker is ON) to the 
default. 


: TCL-PROMPT 'P A'- 

Sets the prompt character to the 

009 DEV- 

current line number and account 


name, followed by dash. 

009 DEV-TCL-PROMPT-OFF 

Resets prompt character to a 


colon (:). 


Available On Any user account. 

See Also tcl-prompt 
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TERM 


Positional 

Syntax 

Keyword 

Syntax 


2-502 


TERM sets the characteristics for the terminal and print jobs for the 
current line. 


TERM {w},{d},{ls},{lfd},{ffd},{bs},{prw},{prd},{code} 


TERM {WIDTH = W> 

{DEPTH = d} 

{LINESKIP = Is) 
{LFDELAY = Ifd} 
{FFDELAY = ffd} 
{BACKSPACE = bs} 
{PRWIDTH = prw} 
{PRDEPTH = prd} 
{TYPE = code) 
{INPUTMODE = imode) 
{MODE = mode) 
{OUTPUTDELAY = opd} 
{TRANSLATE = tchars} 


(S/370 and S/390 only) 
(S/370 and S/390 only) 
(s/370 and S/390 only) 
(S/370 and S/390 only) 


Note: If parameters are omitted, TERM settings for the current line are 
displayed. 


TERM positional parameters and keywords are described below: 

Parameter Keyword Description 

w WIDTH=w Specifies the number of characters per 

line on the terminal, up to 465. 

d DEPTH=d Specifies the number of lines per 

screen on the terminal. 

Is LINESKlP=ls Specifies the number of blank lines 

displayed before the start of the next 
screen page. 
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Parameter Keyword Description 

Ifd LFDELAY=lfd Specifies the number of delay or idle 

characters to output following each 
RETURN or line feed. Used on 
terminals that require a pause after 
RETURN or line feed because the CPU 
generates characters faster than the 
terminal can accept them. 

ffd FFDELAY=ffd Specifies the action to take when a 

terminal or printer new-page condition 
occurs. (Terminal new page occurs at 
term-page-depth + term-line-skip. 

Printer new page occurs at lptr-page- 
depth.) 

Terminal actions include no action, or 
sending a clear-screen character 
sequence and n delay characters. Printer 
actions include no action, or sending a 
top-of-form character sequence. 

If the value entered is 0 (zero), no 
clear-screen or top-of-form character 
sequence is sent to either the terminal 
or the printer. If the value entered is 1, 
no clear-screen character sequence is 
sent to the terminal, but a top-of-form 
character (X'OC) is output whenever a 
new printer page begins, as determined 
by lptr-page-length. 

If the value entered is greater than 1, 
then the terminal screen is cleared at 
the beginning of each terminal page, 
and a top-of-form is output at the 
beginning of each printer page. For 
terminal output, the value entered 
generates that number of delay or idle 
characters to allow the screen time to 
settle. 
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Parameter Keyword Description 

The clear-screen character sequence is 
determined by the terminal-code. 

bs B ACKSPACE=bs Specifies the decimal number whose 

value corresponds to an ASCII 
character. This is used as an alternate 
backspace character in normal input 
mode. An ASCII backspace (<CTRL- 
H> or X’08'), is always interpreted as a 
backspace, bs is always echoed on the 
terminal whenever it is entered. 


prw 

PRWlDTH=prw 

Specifies the number of characters per 



line on the printer. 

prd 

PRDEPTH=prd 

Specifies the number of lines per page 



on the printer. 

code 

TYPE=code 

Specifies the type of terminal, which 


determines functions such as the clear- 
screen character sequence, as well as 
cursor addressing and other 
characteristics specified by such means 
as the BASIC (a) function or the PROC T 
statement. Codes are: 

A ADDS Regent 40 (25-line CRT) 

B Digital VT241 Color Graphics CRT 
C ADDS Viewpoint Color 

D Digital VT100 

E Digital VT200 Series 8-bit mode 
F IBM 3270 terminal 

G IBM 3101 

H Honeywell VIP-7200 

J Heathkit in ANSI mode 

L Liberty Freedom-200 

M Mini tel 

P IBM Personal Computer 
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Parameter Keyword Description 

Q Wyse Wy-50/Ultimate ULT-50 in 
enhanced viewpoint emulation 
mode-extended version 
R ADDS Regent 25 

S Wyse WY-60 in Native mode 

T Wyse WY-50/Ultimate ULT-50 in 

enhanced viewpoint emulation 
mode-extended version 
U Ultimate CRT (Volker-Craig) 

V Ultimate VDT (ADDS Viewpoint) 
W Wyse WY-50 or ULT-50 Enhanced 

Viewpoint 

X Wyse WY-50 or ULT-50 Native 

mode 

Y Wyse WY-85 in VT220 7-bit mode 

Z HP 700/92 

Note: If only terminal-code is to be changed, all other parameters can 
be omitted from the command. 

The following special keyword parameters are part of the Ultimate 
system command TERM and can be used to set up 3270 terminals and 
ASCII terminals connected to the HIFAS. These keywords have no 
meaning for terminals connected to a Series/1. 

Keyword Description 

MODE = mode Specifies the type of terminal or emulation; 

options are: 

ASCII if specified for a terminal 

connected to the HIFAS, terminal 
functions as an ASCII terminal. If 
specified for a 3270 terminal, 
terminal, it causes the screen to be 
considered a single field. 

3270 terminal functions as a 3270 

terminal; TERM type must be F. 
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REMOTE terminal is being accessed 

through a network and functions 
as a 3270 terminal; TERM type 
must be F. 

BLOCK valid only with a 3270 terminal; 
information is sent unchanged 
through the 3270 driver. 

The following keywords are relevant only if a terminal is in 3270 mode 
(MODE = 3270). 

Keyword Description 


INPUTMODE = imode Specifies processing for a command line of 

data; options are: 

ALL specifies that each command line 
is processed in its entirety (the 
default). 

CURSOR specifies only the characters up 
to the cursor are processed when 
RETURN is pressed. 

OUTPUTDELAY = opd Specifies the number of seconds to delay 

before displaying characters on the 
terminal; the number can be specified as an 
integer (n) or an integer plus fraction (n.n). 
The valid range is 0-9.9 ( a 1-3 second 
delay is recommended). 


TRANSLATED'tchars" Specifies modifications to the current 

EBCDlC-to-ASCII terminal input character 
translation table. To return to default, 
specify a null value or the word RESET. 

For information on specifying codes, see 
the section, "Translating Input Characters," 
under the Description section. 




H.,. ^ 
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TERM sets all specified parameters and retains the current values for any 
null parameters for the current line. All non-keyword parameters are 
interpreted by their position in the command. 

When invoked without parameters, the current terminal settings are 
displayed as follows: 

Terminal Printer 
Page width: 79 
Page depth: 24 
Line skip : 0 

LF delay : 1 

FF delay : 5 

Backspace : 8 

Term type : S 

Translating Input Characters 

The default EBCDlC-to-ASCII terminal input character translation table 
translates both lowercase and uppercase EBCDIC letters to the equivalent 
uppercase ASCII letters. 

To specify the TRANSLATE parameter for a new translation, you must 
specify: 

• the EBCDIC code to be converted 

• the ASCII code to convert it to 

The EBCDIC and ASCII codes must be specified as hexadecimal 
numbers. The separator between the EBCDIC codes and the ASCII codes 
can be either a comma or a space. 

If the translation of more than one character is to be changed, specify all 
the EBCDIC codes before the ASCII codes. Use a space to separate each 
EBCDIC code and each ASCII code. You can specify a range using a 
hyphen (-) to separate the first code in the range from the last code. 

To reset all conversions to their default settings, specify either the word 
RESET or "" (null). 


132 

60 
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: termj Display terminal settings for the current 

line. 

: term wj Set terminal code for Wyse WY-50. 

: TERM 79,24, ,, ,8,132,55,YJ 

Change parameters in positional format. 

: TERM TRANSLATE = "81-89 91-99 A2-A9,61-7A"J 

Processes all lowercase EBCDIC as 
lowercase ASCII. 

: TERM TRANSLATE = RESETJ 

Process both uppercase and lowercase 
EBCDIC as uppercase ASCII; this is the 
default. 

: TERM TRANSLATE = "4F,21"J 

Modify one translation code. 

: TERM TRANSLATE = "Cl C2, 41 42”J , 

Modify multiple translation codes. 

: TERM TRANSLATE = "FO-F9,30-39"J 

Modify range of translation codes. 

: TERM TRANSLATE = "" J 

Reset to default table. 

: TERM F MODE = 3270J 

: TERM INPUTMODE = ALL MODE = ASCII OUTPUTDELAY = 1J 


Any user account. 


PRINTER 

SET-TERM 
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Description 
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TERM-INIT sets terminal features for compatibility with Ultimate 
software. 


TERM-INIT 


Use TERM-INIT to set a terminal's features for standard Ultimate 
operation. 

TERM-INIT operation is based on the terminal type defined for the line on 
which the command is entered. When invoked, TERM-INIT displays the 
current type code letter and allows the user to change it, if necessary. 

TERM-INIT supports the following terminal types: 

A ADDS Regent 40 (25-line CRT) 

C ADDS Viewpoint Color 
D Digital VT100 
H Honeywell VIP-7200 
L Liberty Freedom-200 
P IBM Personal Computer 
R ADDS Regent 25 
S Wyse WY-60 in Native mode 
U Ultimate CRT (Volker-Craig) 

V Ultimate VDT (ADDS Viewpoint) 

W Wyse WY-50 or ULT-50 Enhanced Viewpoint 
X Wyse WY-50 or ULT-50 Native mode 

Y Wyse WY-85 in VT220 7-bit mode 
Z HP 700/92 Native mode 

If a terminal type C, S, V, W, X, or Y is selected, prompts are produced 
for you to load function keys. 

If a terminal type A, D, H, L, P, R, or Z is selected, TERM-INIT exits, since 
no programmable features are defined for those terminal types. 

Note: Only function keys 1-10 are loaded. 
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If function keys are loaded, they are programmed to send the code i 
sequences expected by Ultimate software (such as UltiWord) for the 
particular terminal type. 

When initialization is completed, TERM-INIT displays the following: 

Terminal initialization complete 

:TERM-INITJ 

Current terminal type: V 

Enter new type code, or <CR>, or '?’ for help:C 
Terminal initialization complete 

On Any user account. 


TERM 

SET-TERM 
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Syntax 


Description 


TERM-VIEW allows one terminal to view activity and interact with a 
second terminal. 


TERM-VIEW n {({exit-character}{,l})} 

n Specifies the line to which the current terminal is 

to be connected. 


(exit-character Specifies the ASCII value in decimal of the 
character to be used to exit the TERM-VIEW 
process; the default character is the uppercase 
letter X. To exit the process, press ESC followed 
by the exit character. The process can only be 
exited from the terminal that initiated the 
connection. (For a list of ASCII codes, see 
Appendix C.) 


I Inhibits synchronization between terminals of 

output display. The default of the TERM-VIEW 
process is to synchronize the rate of output 
between the two terminals. This option causes 
output to be displayed at the rate set on the 
terminal being viewed. If this rate is higher than 
the rate on the terminal that initiated TERM-VIEW, 
the I option could cause characters sent to the 
initiating terminal to be lost. 


Use TERM-VIEW to access another terminal. For example, in a training 
situation, the instructor can use TERM-VIEW to connect to a student’s 
terminal. In a support situation, a technician can connect to a 
customer's terminal through a modem for direct access to the customer’s 
process. 

Note: If you try to use TERM-VIEW on a line that has never been 
activated after a file restore, the following message is 
displayed: 

[568] Target process has not yet been initialized. 
Use LOGON to activate it. 
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When you use TERM-VIEW, information entered at either terminal is 
accepted as input to the process on the terminal being viewed and is 
echoed on both terminals. Output from the process on the terminal 
being viewed is displayed on both terminals. 

Terminals that are to be connected by TERM-VIEW should be of the same 
TERM type to ensure that screen displays retain their integrity on both 
terminals. 

TERM-VIEW synchronizes the display of output between two terminals. 

If the two terminals have the same baud rate, the display is virtually 
identical. However, if the terminals have different baud rates, there 
might be a slight discrepancy between the screens. For example, if the 
terminal that initiates the command is connected via a modem that is 
running at 1200 baud and the terminal being viewed is running at 9600 
baud, the display at the terminal being viewed is slowed down so that 
the information is displayed at each terminal at approximately the same 
rate. However, because of the buffering capabilities of the terminals, 
the display on the two terminals is not necessarily simultaneous. 

If the I option is specified, the output synchronization is inhibited and 
data is sent at the speed determined by the terminal being viewed. If the 
initiating terminal is operating at a slower speed, characters could be 
lost. If the initiating terminal is operating at a speed equal to or faster 
than the second terminal, the 1 option has virtually no effect. 

The two terminals remain logically connected until the initiator of TERM- 
VIEW breaks the connection by pressing ESC and the exit character. The 
default exit character is the uppercase letter X. 

Note: VT220 terminals do not have <ESC> keys. Break the 
connection by pressing <CTRL-3> followed by the exit 
character. 

Any line can be connected by TERM-VIEW. To prevent a line from being 
set up as a TERM-VIEW line, use TERM-VIEW-OFF. The default setting is 
TERM-VIEW-OFF. 

If you try to use TERM-VIEW on a line that is protected by TERM-VIEW- 
OFF, the following message is displayed: 

[560] Process specified is Term-view protected. 
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Available 

See Also 


: TERM-VIEW 31 (65) J 

: <ESC-A> 

[561] Term-view mode exited. 


Connect the current line to line 31 
and use uppercase A as the exit 
character. All further input on 
either terminal is displayed on 
both terminals. 

Exit term view mode. 


On SYSPROG or SECURITY account. 


TERM-VIEW-OFF 

TERM-VIEW-ON 
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TERM-VIEW-OFF 

TERM-VIEW-OFF protects the specified line against being viewed by 
another line with TERM-VIEW. TERM-VIEW-OFF is the default setting. 


Syntax term-view-off {n} 

n Specifies the line to protect against TERM-VIEW. If 

omitted, the current line is locked. 

Note: Line number can only be specified when using this command 
from the SYSPROG or SECURITY accounts. 


Description Use term-view-off to protect a line from being connected to another 

line. 

Note: TERM-VIEW-OFF will break a currently active TERM-VIEW 

session. 

If TERM-VIEW-OFF is issued for the current line, it disables TERM-VIEW 
unconditionally. It also prohibits another process from issuing a TERM- 
VIEW-ON command that would affect the current line. Only a TERM- 
VIEW-ON from the same line can re-enable TERM-VIEW. 


: term-view-off 31J Prevent line 31 from being 

connected to another line. 


Available On sysprog or security account. 


See Also term-view 

TERM-VIEW-ON 
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TERM-VIEW-ON 

TERM-VIEW-ON enables the specified line to be viewed by another line 
with TERM-VIEW. 


Syntax term-view-on {n} 

n Specifies the line to enable for TERM-VIEW. If omitted, 

the current line is unlocked. 


Description Use TERM-VIEW-ON to enable the use of TERM-VIEW by a line that has 

the default TERM-VIEW-OFF protection. If that line was previously 
disabled for viewing by a TERM-VIEW-OFF issued by that line, the 
following error message is displayed: 

[587] Process specified is TERM-VIEW-ON disabled. 


When TERM-VIEW-ON is issued for the current line, both TERM-VIEW 
and TERM-VIEW-ON from another line are enabled. The effect is to bring 
the process back to its log-on default status. 


: TERM-VIEW-ON 31J 

Allow line 31 to be connected to 

: 

another line. 


Available On sysprog or security account. 


See Also term-view 

TERM-VIEW-OFF 
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TERMINAL 

Syntax 

Description 
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TERMINAL allows parameters associated with a line to be reviewed 1 and 
changed. 


TERMINAL 


Use TERMINAL to set parameters for a new line being added to the 
system, or to view or modify an existing line’s parameters. 

When invoked from the SECURITY account (or from SYSPROG with 
security enabled), TERMINAL prompts for line number: 

---v 

ULTIMATE Terminal Processor 

Line Number : 


^_*** Enter "#" for this Line Number ***_ 


To display the terminal parameters for the current line, enter#. To 
return to TCL, press RETURN. To set parameters for a new line, or to 
change parameters for an existing line, enter a line number at the 
prompt. 

Note: If invoked from an account other than SECURITY or SYSPROG, 
no line number prompt is displayed, since you can only set 
terminal parameters for the current line. 

A screen similar to the following is displayed: 
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r 


ULTIMATE Terminal Processor| 


Line Number: 001 


Current Parameters Logon Parameters 


1. 

Baud Rate : 9600 

8 . 

Baud Rate : 9600 

2. 

Character Length (5,6,7,8) : 8 

9. 

Character Length (5,6,7, 8) : 

3. 

Stop Bits (1,2) : 2 

10 . 

Stop Bits (1,2) : 2 

4 . 

Parity (EVEN,ODD,NONE) : EVEN 

11. 

Parity (EVEN,ODD,NONE) : EVEN 

5. 

Echo (ON,OFF) : ON 

12 . 

Echo (ON,OFF) : ON 

6. 

Xon/Xoff (ON,OFF) : ON 

13. 

Xon/Xoff (ON,OFF) : ON 

7 . 

Type Ahead (ON,OFF) : ON 

14 . 

Type Ahead (ON,OFF) : ON 



15. 

Terminal Type : W 



16. 

Loc : Front Office 

Logon 

Security 



17 . 

Logon Attempt Restrictions (ON, 

OFF) 

: ON 


18. Allowable Attempts per Session : 10 

19. Disable Time for Session Violation (HH:MM:SS) : 00:02:00 

20. Allowable Attempts per Day : 20 

21. Disable Time for Day Violation (HH:MM:SS) : 00:02:00 

Enter Option (#,EX,FI) : 

V___ 


N ote: To move quickly from field to field or to exit or save your 
changes from any field, enter a slash (!) followed by a field 
number or command. For example, enter 13 to go to field 3, 
/EX to exit without saving changes, or IFI to file all changes. 

If the command is entered from a non-security account, the values for 
the current line are shown. 

Each option displays default values, with the cursor positioned at the 
first entry. New values can then be entered. After the values have been 
entered, the following prompt is displayed: 

Enter Option (#,EX,FI): 


6985 - 3.2 


Ultimate System Commands Guide 

Confidential and Proprietary to The Ultimate Corp. 


2-517 




TERMINAL 


Available 

See Also 


2-518 


To change any entries, enter the field number (see below). To exit this 
screen without saving any entries, enter EX. To file the account¬ 
defining item and create the account, enter FI. 

Current Parameters - Options 1 through 7 

Options 1 through 7 display the communications parameters currently in 
effect for a selected line. You can also change these parameters via SET- 
BAUD. 

Logon Parameters - Options 8 through 15 

Options 8 through 15 display the default parameters used by this line 
every time the logon prompt is reached. These parameters are displayed 
from parameters 2 and 3 of DICT ACC, and revised values are recorded 
in the line's DICT ACC. 

Location Parameter - Option 16 

Option 16 specifies the location displayed for the line by LISTU{SERS) 
(attribute 1 of the line's item in DICT ACC.) 

Logon Security Parameters - Options 17 through 21 

Options 17 through 21 override the system global parameters set with 
the SECURITY- STATUS command. 


On SYSPROG or SECURITY account. 


LISTUfSERS) 

SECURITY-STATUS 

SF.T-BAUD 

TERM 

System Management Guide for information on terminal values and 
setting up terminal security. 
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Syntax 

Description 


Available On 

See Also 


TIME displays the current system time and date. System time is based 
on the 24-hour clock. 


TIME 


TIME displays the current system date and time as follows: 

HH:MM:SS DD MON YYYY 

Hours are entered and displayed in 24-hour format, where midnight is 
00:00:00, 1 a.m. is 01:()():()(), noon is 12:00:00, and 1 p.m. is 13:00:00. 

The system updates the date at midnight (00:00:00). 

:TIMEJ 

16:15:00 01 NOV 1991 


Any user account. 


DATE 

SET-DATE 

SET-TIME 
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TRANSLATE 


Syntax 


Description 
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INPUT 


TRANSLATE-INPUT creates a translation table that can be used to translate 
characters input to or output by the system. Using this table, any 
character or sequence of characters can be translated to any other 
character or sequence of characters. 


TRANSLATE-INPUT {filename {item-lD}} 

filename Specifies the file in which to place translation table. If 
omitted, the system prompts for it. 

item-lD Specifies the item in which to place the translation table. 
If omitted, the system prompts for it. 


Use TRANSLATE-INPUT whenever characters that are input or output 
need to be translated to other characters. For example, TRANSLATE- 
INPUT can be used to translate lowercase letters to uppercase letters, or 
to specify characters for foreign keyboards. 


You can also use TRANSLATE-INPUT to translate keys for terminal 
emulations or for serial printers (must be enabled for output only). 


The following system commands are available for translations: 

• TRANSLATE-INPUT Defines a translation table. 

• TRANSLATE-LOAD Makes the table available to a line. 

• TRANSLATE-ON Enables the actual translation to start. 

• TRANSLATE-OFF Stops the translation. 


A translation table consists of a set of zero or more translation 
sequences. A translation sequence is identified by the first character in 
the sequence to be translated. Thus, there can be zero to 256 translation 
sequences in a table. Any of these sequences can consist of multiple 
parts to allow for differing sequences following the first character. 


Each translation sequence can include the following components: 
• Character ID (the unique first character). 
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• Zero or more sequences of additional characters associated with the 
character ID. 

• Sequences of translation characters, each corresponding to a 
sequence of additional characters (if any). 

• Zero or more flag settings, used to set display options. There is one 
for each sequence of additional characters. 

Each of these components is explained below. 

Character id 

The first character in each translation sequence is called the character ID. 
The character ID is entered in hexadecimal. You can define up to 256 
unique character IDs. 

The translation sequence is stored in the attribute whose number is the 
decimal value of the character ID plus 1. 

There can be multiple additional character sequences for each character 
ID. Each additional-character sequence has a corresponding translation- 
character sequence entry and a flag-settings entry. All translation 
sequences for one character ID are stored as values in the attribute. 

If TRANSLATE-INPUT is entered without filename or item-ID, it prompts 
for them. For example, at the prompts, enter CUST.FILE for the 
filename and AI5C100 for the item-ID. A screen similar to the following 
is displayed: 


r 


File name: CUST.FILE Item name: ABC100 status-msg 


Char id : 


Enter char in hex 




(ex: 1 A' = 1 41 1 , 1 


1 = , 20 , ) f or <CR> to exit 


Character ID is the ASCII value in hexadecimal of the character to be 
translated. If a sequence of characters is to be translated, character ID is 
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the first character. For example, to translate the sequence ESCaO, enter a 
character ID of IB, which is the hexadecimal code for ESC. The decimal 
equivalent of the hexadecimal value is displayed, and if possible, the 
ASCII representation of the character. Any existing translation 
sequences for this character ID are displayed. 

Additional Characters 

If additional characters are associated with the character ID, the system 
prompts for them as follows: 

— 

File name: CUST.FILE Item name: ABC100 status-msg 

Char id : IB Decimal value = 27 


Enter any additional characters in hex or CTL-X to exit 


Each character ID can be associated with any number of additional 
character sequences, with up to 10 hexadecimal characters in each 
sequence. Each sequence must be unique and no complete sequence can 
be identical io the beginning characters of another sequence. 

For example, if you have a sequence defined for 123456, you cannot 
have a sequence 1234. However, you can have sequences 123456 and 
1235, or sequences 123456 and 123457. 

To translate a sequence of characters, enter the additional characters as a 
single string of hexadecimal characters. For example, to translate the 
additional characters in the sequence ESCaO, enter 6130, which is the 
hexadecimal representation of aO. If there is no sequence following the 
character ID, press RETURN. To return to the character ID prompt, 
press <CTRL-X>. 
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Translation Characters 

After you enter any additional characters, the system prompts for the 
translation characters as follows: 

-\ 

File name: CUST.FILE Item name: ABC100 status-msg 

Char id : IB Decimal value = 27 

6130 . 

Enter any translation characters in hex 

_ J 

Enter the character or sequence of characters to which the specified 
characters are to be translated. For example, if ESCaO is to be translated 
to the character A, enter 41. 

Flag Settings 

TRANSLATE-INPUT then prompts for the flag settings, which determine 
display options: 

— 

File name: CUST.FILE Item name: ABC100 status-msg 

Char id : IB Decimal value = 27 

6130 41 

Enter the flag settings in hex 

_I_ J 

There are currently only two flags defined. One specifies if the original 
character is echoed to the screen, and the other specifies if the translated 
character is echoed. Possible combinations are: 


Ultimate System Commands Guide 2-523 

Confidential and Proprietary to The Ultimate Corp. 







TRANSLATE-INPUT 


Available 

See Also 

2-524 


00 Echo both source and translated characters. 

40 No echo on translated characters. 

80 No echo on source characters. 

CO No echo on source or translated characters. 

To list the currently available flag settings on-line, press the question mark 
key (?). 

After the flag setting is entered, you can enter another sequence of 
additional characters at the prompt. Enter as many sequences as desired. 

After all sequences for the current character ID have been entered, return 
to the Char id prompt by pressing <CTRL-X> at the Additional 
characters prompt. 

The system then checks the additional character sequences to make sure 
they are valid. If any invalid entries are found, the first invalid one is 
displayed. For example, if a sequence is entered that is identical to the 
beginning of a second sequence, the following message is displayed: 

Ambiguous translate string 


Press RETURN. You can then change any of the information. Use the 
arrow keys to move from field to field. When the information is 
correct, press <CTRL-X> at the prompt. 

TRANSLATE-INPUT displays the Char id prompt. Continue entering 
translation information. When all translation information has been 
entered, press RETURN. The following prompt is displayed: 

FI to file, <F2> or X to void, <CR> to continue: 

To file and save the table, enter FI. To exit without changing the table, 
press function key <F2> or enter X. To enter additional translation 
characters, press RETURN. 


On Any user account. 


TRANSLATE-LOAD 
TRANSLATE -OFF 
TRANSLATE-ON 
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TRANSLATE-LOAD makes the specified translation table available to a 
line. 

Syntax TRANSLATE-LOAD {n} {filename {item-lD {INP}}} 

TRANSLATE-LOAD {n} {filename {item-lD {OUT}}} 

n Specifies the line on which to make the translation table 

available. If omitted, the current line is assumed. 

filename Specifies the file that contains the translation table. If 
omitted, the system prompts for it. 

item-lD Specifies the item that contains the translation table. If 
omitted, the system prompts for it. 

INP Uses the table for input translation. If omitted, the 

system prompts for the direction. 

OUT Uses the table for output translation. If omitted, the 

system prompts for the direction. 

Description Use TRANSLATE-LOAD to make a translation table available to a line. 

Each line can have one input and one output table assigned at the same 
time. Assigning a table does not enable it. For information on enabling 
the table, see TRANSLATE-ON. 



Available On Any user account. 


See AISO TRANSLATE-INPUT 

TRANSLATE-OFF 
TRANSLATE-ON 
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TRANSLATE-OFF 

TRANSLATE-OFF turns off character translation for a specified line. 

Syntax translate-off {n} inp 

TRANSLATE-OFF {n} OUT 

n Specifies the line on which to turn off translation. If 

omitted, the current line is assumed. 

INP Turns off input translation mode. 

OUT Turns off output translation mode. 

Description Use TRANSLATE-OFF to stop a translation on a specified line. 

When invoked to turn off input translation, the following message is 
displayed: 

[563] Input translation mode OFF for process n. 

When invoked to turn off output translation, the following message is 
displayed: 


[565] Output translation mode OFF for process n . 



Available On Any user account. You must have privilege level 2 to change a line 

other than your own. 


See AISO TRANSLATE-INPUT 

TRANSLATE-LOAD 

TRANSLATE-ON 
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Syntax 


Description 


ON 

TRANSLATE-ON turns on character translation for a specified line. 


TRANSLATE-ON {n} INP 

TRANSLATE-ON {n} OUT 

n Specifies the line on which to turn on translation. If 

omitted, the current line is assumed. 

INP Turns on input translation. Characters entered at the 

keyboard are translated before being recognized by the 
system. 

OUT Turns on output translation. Characters generated by the 

system for output are translated before they are output. 


Use TRANSLATE-ON to start a translation on a defined line. A 
translation table must have been loaded previously with translation in the 
same direction specified by the option in TRANSLATE-ON. If no such 
table is found, the following error message is displayed: 

[567] No translation table loaded for process n 

When you use TRANSLATE-ON to turn on input translation, the 
following message is displayed: 

[562] Input translation mode ON for process n. 

When you use TRANSLATE-ON to turn on output translation, the 
following message is displayed: 

[564] Output translation mode ON for process n. 
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Available 


See Also 


: TRANSLATE-ON 4 OUT J 

[564] Output translation mode ON for process 4. 


On Any user account. You must have privilege level 2 to turn on the 
translation table for a line other than your own. 


TRANSLATE-INPUT 
TRANSLATE-LOAD 
TRANSLATE -OFF 
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TRANSMIT transmits Ultimate file items to another computer using 

bisynchronous communication protocol. 

TRANSMIT filename {itemlist} {(options)} 

filename Specifies the file containing the items to be transmitted. 

itemlist Specifies one or more explicit item-IDs, or an asterisk 

(*) to specify all items in the file. Can be omitted if a 
select-list is present. 

(options 

A Transmits 3780-format messages. 

H Transmits in transparent mode. This option allows 

bisync characters to be sent as data (such as X'()3’). 

J Turns space compression off. Space compression only 

exists in 3780 protocol. 

L Pads all short records with blanks. 

M Removes 80-character limit on transmission record size. 

The maximum transmission record size is three bytes 
less than the buffer size (400 bytes for 2780-format, 512 
bytes for 3780-format). 

N Changes number of transmission records sent in a block. 

The maximum number of transmission records per block 
is the same as the default (7 for 2780 and 100 for 3780). 
The command prompts for the number of transmission 
records to send in each block. If the response is 
incorrect (that is, less than 1 or greater than the default), 
the command re-prompts for a valid number. 

O Concatenates all items being transmitted together in one 

transmission message, instead of transmitting one item 
per message. 

R Treats a Reverse Interrupt (RVI) sequence as a positive 

acknowledgment, continues to transmit data, and does 
not relinquish the line. Use with caution since this 
sequence is normally considered a bug. 
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Description 
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S Selects secondary station status when bidding for the 

line. If omitted, the primary station is the default. 

T Terminates the process and return to TCL after 

transmitting the itemlist, instead of returning to the 
receive mode. 

Note: If the T option is omitted, TRANSMIT can also specify 
receive options available in the RECEIVE command. 
RECEIVE options take effect after auto turnaround when the 
terminal goes into receive mode. 

U Specifies Ultimate mode. The item-lD of the item to be 

transmitted becomes the first record of the transmission 
message. Short records do not have an EM character 
(X'19') appended to them. The maximum transmission 
record size is increased to 500 characters. The maximum 
transmission block size is increased to 502 bytes. 

W Returns to TCL if the message WAITING FOR 

COMMUNICATIONS LINE TO BE CONNECTED is 
displayed. 

X Specifies the terminal identification string sent by the 

local computer when bidding for the communications 
line. When the remote computer is bidding to transmit to 
the local computer, this string gets sent with the 
acknowledgement from the local computer. 

Y Prompts for a fixed number of characters per record. 

The maximum value is 500 if the U option is specified; or 
397 if the U option is omitted. This option automatically 
invokes the L and M options. This option is not 
supported while transmitting 3780-format items, or 
during transparent mode. 

Use TRANSMIT to set a terminal to transmit status when performing 
bisync data communications. TRANSMIT assumes that the line is already 
attached to a bisync communications controller via B-ATT. Use the BSC- 
DIAL command before invoking TRANSMIT if you have a UDS 201 C/D 
modem or a UDS 208 B/D modem. 
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TRANSMIT 


Available On 
See Also 
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Note: When using the TRANSMIT command to transmit bisync 

messages, be sure that the receiving end uses the same 
protocol as the TRANSMIT command. That is, both must use 
2780 mode or both must use 3780 mode. The 2780 mode is 
the default. 

TRANSMIT options allow you to select alternative transmission methods, 
and to return to TCL after the transmission is complete. 

If options are omitted, each item is sent as a separate transmission 
message. Each attribute in an item becomes one transmission record 
with a maximum length of 80 characters. Shorter attributes have an EM 
character (X'19') appended to them. 

After transmitting the itemlist, the line automatically starts the receive 
mode (also called the auto-turnaround). If auto-turnaround is used, you 
can specify RECEIVE options in the TRANSMIT command's option 
string. These options take effect after the terminal does auto-turnaround 
and goes into receive mode. 

After TRANSMIT sets up the transmission parameters, dial the computer 
that will receive the data. When a connection is made, the data can be 
transferred in data mode. After the transmission, depending on the 
options selected, control returns to TCL or goes into the receive mode 
for two-way communications with the other computer. 

You can halt transmission and return to TCL at any time by doing a 
<BREAK> and END. 

:TRANSMIT CUSTOMER * (TJ 

[128] --Waiting for communications line to be connected 

Dial the other computer. 

[129] --Communications line connected-- 
220 records transmitted 


Note: The messages displayed depend on your situation. For 

example, if the line is already connected, the message Waiting 
for Communications Line to be Connected is not displayed. 

SYSPROG or SECURITY account. 

B-ATT 

B-DET 

RECEIVE 

System Management and Support Guide 
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TYPEAHEAD-OFF 


TYPEAHEAD 

Syntax 

Description 


Available On 

See Also 


-OFF 

TYPEAHEAD-OFF turns off the typeahead feature. Typeahead on is the 
default setting. 


TYPEAHEAD-OFF 


TYPEAHEAD-OFF turns off the typeahead feature for the current line. 
(Typeahead allows you to enter characters while the system is busy. 
These characters are later displayed and accepted when the system 
requests input.) 

When typeahead is turned off, it remains off until restored by a 
TYPEAHEAD-ON from the same terminal, until it is set with the SET- 
BAUD command, or until the line is logged off and on again. 

Once TYPEAHEAD-OFF is active, you must wait until the system requests 
terminal input (usually via a prompt character) before typing data. If the 
system is busy and you try to enter data, a bell rings at your terminal. 

TYPEAHEAD-OFF also turns off the PAGEIO mode on LSI systems where 
the normal input mode is on. You can, however, turn the PAGEIO mode 
back on with PAGEIO-ON or TYPEAHEAD-ON. TYPEAHEAD-OFF does 
not affect the PAGEIO mode on systems where the normal input mode is 
PAGEIO-OFF. 


Any user account. This command is not available on Ultimate S/370 or 
S/390 systems. 


PAGEIO-ON 

SET-BAUD 

TYPEAHEAD-ON 
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TYPEAHEAD-ON 


TYPEAHEAD 

Syntax 

Description 


Available On 

See Also 


6985-3.2 


-ON 

TYPEAHEAD-ON enables the typeahead feature for the current line. 


TYPEAHEAD-ON 


TYPEAHEAD-ON allows you to re-enable the typeahead feature after it 
has been disabled by TYPEAHEAD-OFF. (Typeahead allows you to enter 
characters while the system is busy. These characters are later displayed 
and accepted when the system requests input.). If typeahead is already 
on, the command has no effect. 

The typeahead feature remains on until disabled by TYPEAHEAD-OFF 
executed from the same terminal, or until reset by the SET-BAUD 
command. 

TYPEAHEAD-ON also turns on the PAGEIO mode for LSI systems where 
the normal input mode is PAGEIO on. It does not affect systems where 
the normal input mode is PAGEIO off. 

If you exceed the typeahead buffer capacity, a bell rings at your 
terminal. 


Any user account. This command is not available on Ultimate S/370 or 
S/390 systems. 


PAGEIO-ON 

SET-BAUD 

TYPEAHEAD-OFF 

X-OFF 

X-ON 
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ULTNVIENU 

Syntax 

Description 

Available On 

See Also 
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ULTI*MENU displays the SYSPROG Load Ulti's menu for restoring 
Ultimate utility accounts from the SYS-GEN tape. It should not be used 
at any other time. 


ULTI*MENU 


For further information on ULTI*MENU, please refer to the upgrade 
procedures for your system. 


SYSPROG or SECURITY account. 


System Management Guide. 
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UL71K1T 

Syntax 

Description 

Available On 


6985-3.2 


ULTIKIT invokes the UltiKit application development environment that 
contains tools to build, test, run, and modify new and existing 
applications. 


ULTIKIT 


For information on using ULTIKIT, invoke the UltiKit's help facility 
from the UltiKit Main Menu by pressing the question mark (?) key. 


Any user account. 
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UNLOCK-FRAME 


UNLOCK-FRAME 


UNLOCK-FRAME unlocks a memory-locked frame. 


Syntax unlock-frame n 

n Specifies the decimal number of the frame to be 

unlocked. 


Description UNLOCK-FRAME unlocks a frame that has previously been locked by 
LOCK-FRAME by clearing the memory-locked buffer status of the 
specified frame. 


: UNLOCK-FRAME 2040J 


Available On sysprog or security account. 

See Also lock-frame 
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UPD-DEF 


UPD-DEF 


Syntax 


Description 


Available On 


6985 - 3.2 


UPD-DEF creates Ultimate UPDATE dictionary items for use with 
Ultimate UPDATE commands. 


UPD-DEF {filename} 

filename Specifies the file to contain the Ultimate UPDATE 
dictionary definition items. If omitted, the system 
prompts for it. 


For further information on UPD-DEF, please refer to the Ultimate 
RECALL and Ultimate UPDATE User Guide. 


Any user account. 
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UPD-VALIDATE 


UPD-VALIDATE 

UPD-VALIDATE validates Ultimate UPDATE dictionary definitions for a 
file so they can be used in Ultimate UPDATE commands. 

Syntax upd-validate {filename} {lptr} {(p) 

filename Specifies the file containing dictionary definitions to be 
validated. 

LPTR Routes output to the spooler. 

(P Same as LPTR. 

Description For further information on UPD-VALIDATE, please refer to the Ultimate 

RECALL and Ultimate UPDA TE User Guide. 

Available On Any user account. 


2-538 


Ultimate System Commands Guide 
Confidential and Proprietary to The Ultimate Corp. 


6985 - 3.2 


UPDATE 


UPDATE 


Syntax 


UPDATE is used to update a database file according to Ultimate UPDATE 
dictionary definitions and expressions. 


UPDATE filename item-lD.expr {attr.expr} {literal {...}} 
{modifiers} {(options) 

filename Specifies the primary file to be updated. 

item-lD.expr Specifies the update expression for the item-ID's 
screen placement. 

attr.expr Specifies the attribute name from the dictionary of the 

file being updated. 


No te : item-ID.expr and attr.expr can have the following form: 


(@(xl,y) {{ : : @(-n)} : "tag" { : @(x2) }} : } {attr-name{[l,len]}} 


where: 

xl 

y 

IMI 


-n 

"tag" 

x2 

attr-name 

1 

len 


Column to display attribute name or tag. 

Row to display attribute. 

Required if @(-n) is specified. 

Sets visual attributes. 

Text to be displayed instead of the tag specified in the 
Update definition item. 

Column in which to display data. 

Name of Update definition item; name for item- 
ID.update.expr must be IDO. 

Literal 1 (one). 

Number of characters in attribute to display. 


m o d i fi e r s Screen formatting connectives: 

heading Defines headings as in RECALL. 

FOOTING Defines customized option prompt. 
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UPDATE 


Description 


Available On 
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NEXT-SCREEN Specifies multiple screens. 

WINDOW Specifies format of multi-valued attributes. 

END-WINDOW Specifies end of window. 

(options 

nn Specifies visual attribute used to display literal 

fields; see TCL-PROMPT for list (uses only number, 
not the minus sign). 

A Uses lower case letters instead of numbers as field 

identifiers. 

B Disables the <BREAK> key. 

F Specifies <FI> must be entered to save item. 

H Specifies ? must be pressed to display help 

messages. 

L Displays literal fields in low intensity. 

M Specifies existing items are display only; new items 

can be created. 

N Specifies new items cannot be created; existing 

items can be displayed and updated. 

R Automatically generates RETURN when maximum 

characters are entered. 

S Displays entire screen when item-ID is entered. 

V Specifies existing items are display only; new items 

cannot be created. 

X Specifies FD can be entered to delete item. 


For further information on UPDATE, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 


Any user account. 
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UPDATE-ACCOUNT 

UPDATE-ACCOUNT allows updating of account parameters. It is a 
synonym for the CREATE-ACCOUNT command. 


Syntax UPDATE-ACCOUNT {accountname} 

accountname Specifies the account to be updated. If omitted 

and the user is on a security account, the system 
prompts for an accountname. Users on non¬ 
security accounts can only update the current 
account. 


Description Use UPDATE-ACCOUNT to modify a user account, or a synonym (Q- 

pointer) to an existing user account. 

Only users on security accounts (SECURITY or SYSPROG with security 
enabled) can update accounts other than the current account. Users on 
non-security accounts can only update certain parameters for the current 
account. 

For further information, please refer to the CREATE-ACCOUNT 
command. 


Available On Any user account to update the current account. SECURITY account or 

SYSPROG with security enabled to update other accounts. 
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UPDATE-FILE 


UPDATE-FILE 


Syntax 


2-542 


UPDATE-FILE allows updating of file parameters. It is a synonym for 
the CREATE-FILE command. 


UPDATE-FILE {filename {parameterl} {parameter!}} 

Note : If parameterl and parameter2 are both omitted, a screen is 
displayed for entering file parameter values. 

filename Specifies the file to be updated. If omitted, the system 
prompts for it. 

parameterl Creates the modulo, separation, and hashing algorithm 

for the dictionary section of the file. These values can be 
user-specified with the following format: 

mod,sep{,alg} 

where: 

mod Number of groups in primary storage; the 
maximum modulo is 16,777,213. 

sep Number of frames per group. Separation must 
be a number from 1 through 127 when the 
modulo is 1 through 64K, and must be 1 when 
the modulo is greater than 64K. 

alg Hashing algorithm used to determine group in 

which items are placed. If omitted, the algorithm 
is 1 if the modulo is less than 64K, or 2 if the 
modulo is greater then 64K. 

Use the following Automatic Modulo Calculation format 
to automatically calculate values for the dictionary section 
of the file's modulo, separation, and hashing algorithm: 

AC, nl,n2{,alg} 

where: 
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Description 

Available On 
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A C Invokes the routine to calculate the modulo for 
this file section. 

n 1 Estimated number of items in this file section. 

n 2 Estimated size of each item in this file section. 

alg Hashing algorithm used to determine in which 

group items are placed. If omitted, the algorithm 
is 1. 

parameter! Creates the modulo, separation, and hashing algorithm 
for the data section of the file. These values can be 
specified exactly as shown for parameterl above. 


For further information, please refer to the CREATE-FILE command. 


Any user account. 
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UPGRADE COMMANDS 


UPG-REV 

UPG-REV.WC 

UPG-SYSPROCLIB 

UPG-ULTIS 

UPG-ULTIS.WC 


The upgrade commands listed above are used when upgrading to a new 
release of the Ultimate operating system. 


For further information on these commands, please refer to the upgrade 
procedures for your system. 
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USER-COLD-START 


USER-COLD 

Syntax 

Description 

Available On 

See Also 


START 

USER-COLD-START is a PROC executed at the end of every coldstart to 
allow custom features such as starting additional printers or reinitializing 
application software. 


USER-COLD-START 


As supplied by Ultimate, USER-COLD-START starts the system printer 
via SP-STARTLPTR, initializes the printer control block, and loads the 
user modes into the system. 

You can modify this PROC to start additional printers, initialize 
applications, and perform various other tasks before users log onto the 
newly coldstarted system. 


SYSPROG account. 


COLDSTART 

Guide to the Ultimate Editor for information on editing items. 

Ultimate PROC Reference Guide for information on modifying PROCs. 
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USORT 


Syntax 


Description 


Available On 


2-546 


USORT prints all Ultimate UPDATE dictionary items for a specific file. 

USORT {filename} {LPTR} {{P} 

filename Specifies the file for which Ultimate UPDATE dictionary 
definition items should be listed. If omitted, the system 
prompts for it. 

LPTR Routes output to the spooler. 

(P Same as LPTR. 

For further information on USORT, please refer to the Ultimate RECALL 
and Ultimate UPDATE User Guide. 

Any user account. 
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VERIFY-SAVE 

VERIFY-SAVE verifies the integrity of a tape made during a FILE-SAVE or 
ACCOUNT-SAVE. This command does not verify the integrity of a tape 
made by all-update-save or part-update-save. 

Syntax verify-save {(options} 

(options 

A Does not rewind the tape. Use this option to verify tapes 

that contain multiple account-saves. If omitted, VERIFY- 
SAVE always rewinds the tape before beginning the 
verification. 

D Specifies debugging option. Prompts with a continue or 

quit message whenever an item-size error, a tape format 
error, or an object item error occurs. 

N Does not create the VSAVE-STATS file. Ultimate 

recommends that you only use this option when there is 
not enough disk space for the statistics. 

Description VERIFY-SAVE checks the tape on the attached drive for the following 
types of errors: 

• Item-size errors Number of bytes for the item differs from 

the actual number of bytes in the item. 

• Object item errors Number of frames for the BASIC object 

code or save-lists differs from the actual 
number of frames. 

• Tape format errors Expected format of the next tape record 

differs from the actual format. 

Note: These errors indicate that the tape is not reliable and should not 

be used to restore your system. Produce a new tape instead. 

The statistics for the report are saved on a SYSPROG file called VSAVE- 
STATS. Use the LIST-VSAVE-STATS to list statistics reported by VERIFY- 
SAVE. For information on using the VSAVE-STATS file, see LIST- 
VSAVE-STATS. 
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VERIFY-SA VE 


Available 

See Also 


_ H 

:VERIFY-SAVEJ 

FI LEA 
FILEA 
FILEB 
FILEB 


14:18:56 07 MAR 1991 Mount reel #2 
Label : 07 MAR 1991 DATA accountname File-Save 
(C)ontinue/ (Q) uit ?CJ 
FILEM 
FI LEM 


FILEZ 

FILEZ 


On SYSPROG or SECURITY account. 


ACCOUNT-SAVE 

FILE-SAVE 

LIST-VSAVE-STATS 

SAVE 

T-CHK 
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VERIFY-SYSTEM 


VERIFY-SYSTEM 

VERIFY-SYSTEM checks for errors in the system assembly language 
(ABS) software. 

Syntax verify-system 

Description Use VERIFY-SYSTEM if you suspect errors in the system software. 

VERIFY-SYSTEM generates a check-sum for every frame of assembly 
language software (ABS), from frame 1 to frame 2047. These check-sums 
are compared with those in an item named CHECK-SUM in the ERRMSG 
file. The CHECK-SUM item contains the correct check-sum for the ABS 
frames. 

Each attribute in the item contains a check-sum for one frame of code, or 
else it is null. If an attribute is null, the corresponding frame is ignored, 
since it contains no system assembly code. 

If all the software frames verify, the following message is displayed: 

[341] Ultimate system software verified. 

If a frame generates a check-sum that does not match the correct check¬ 
sum in the CHECK-SUM item of ERRMSG, the two check-sums are 
printed and the following message is displayed: 

[342] *** Ultimate system software does not verify! 

*** There are n frames with mismatches. 


If the system does not verify successfully, it must be restored by a 
coldstart. 


: VERIFY-SYSTEMJ 

[341] Ultimate system software verified. 


Available On sysprog or security account. 
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VIEW 


VIEW 

VIEW retrieves specified or all entries from the TCL stack for display, 

editing, or execution. The TCL stack contains TCL commands 

previously executed on the current line when the stack is on. 

Syntax VIEW {n} {n-m} {string} {(P} 

n Specifies the stack entry number containing the 

command to be viewed. If omitted, the entire stack is 
displayed. 

n-m Specifies a range of stack entry numbers containing the 

commands to be viewed. If omitted, the entire stack is 
displayed. 

string Specifies a character string that matches the beginning 

character string of a command to be viewed. The string 
can include the Editor wild card character ( A ). 

Note: Either n, n-m, or string may he specified, hut not a 
combination. 

(P Routes output to the spooler. 

Note: If parameters are omitted, the entire stack is displayed. 

Description Use VIEW to display TCL commands previously executed on your line. 

For complete information on viewing the TCL stack, please refer to the 

section "Using Command Stacks" in Chapter 1. 
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VIEW 


Available 

See Also 


: VIEWJ 

Seq Sentence 

001 WHO 

002 WP-OUT WP-DOCUMENTS,PAYROLL DOC.1 (P 
003 LIST ONLY WP-DOCUMENTS 
004 LISTUSERS 

005 ED BP CUSTOMER.MAINTENANCE 
006 LISTFILES 

: view wj Search for the first occurrence of 

: who a command starting with W. 


On Any user account. 


. (period) 

CLEAR-STACK 

SET-STACK 

Chapter 1 of this document for further information on the TCL stack. 
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WHAT 


WHAT 


Syntax 


Description 


2-552 


4 "\ 


WHAT displays the current status of the system, including system 
configuration, lock and spooler status, and location of lines currently 
logged on. 


WHAT {'accountname'} {n{-m}} {(options} 


'accountname' 


n{-m} 

(options 

L 

P 


S 


w 

z 


Displays line information (as in WHERE) for the 
specified account name only. The account name 
must be enclosed in single quotes. 

Displays line information (as in WHERE) for 
specified line n or range of lines n-m. 


Suppresses display of lock information. 

Routes output to the spooler. 

Suppresses display of spooler status (as in SP- 
STATUS). 

Suppresses display of line number status (as in 
WHERE). 

Displays all line numbers in the system (as in 
WHERE). 


Note: If parameters are omitted, all system status information is 

displayed at the terminal. 


4 "\, 

v x w y / 


Use WHAT to check the entire system status, or to check the status of 
specific accounts, lines, or the spooler. 

If a line is currently running on more than one TCL level, the statistics 
for all TCL levels are displayed. WHAT can display the status of all 
system printers. 

When invoked without parameters, WHAT displays the following 
information: 
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System 

Information 

Group/Item 

Locks 

BASIC 

Locks 

System 
Lock Bytes 

Line 

Information 

Spooler 

Information 


System information consists of the following: 

Memory Displays the current real memory size. 

PIBs Number of communication lines (terminals), plus 1 

(spooler), plus 1 (warmstart), plus 2 (UltiNet) for a total 
number of processes on the system. 

Lines Number of communication lines. 

On Number of lines logged on. 

PC B 0 The PCB FID for line zero. 

Wssize Extended workspace size. There are three extended 
workspaces per line. 

Sysbase/ System base FID/modulo/separation. Sysbase is 

mod/sep calculated as: Sysbase = (Wssize*3*PlBs)+l. 
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WHAT 


Group & 

Item 

Lock 

Information 


BASIC Locks 
Information 


System Lock 
Bytes 

Line 

Information 
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Maxfid 

Maximum disk FID. 

Ovf 

Available space, which is the number of linked frames 
plus contiguous frames. 

Abs 

frmsize 

The size in bytes of each frame in the ABS section of 
the operating system. 

Data 

frmsize 

The size in bytes of each frame of the data (files) section. 

Linksize 

The number of bytes reserved to link frames. These 
bytes are at the start of linked frames, and contain 
information about the forward and backward links for 
the frame. 

The group and item lock information is in the following format (also 
used by the LIST-LOCKS command): 

ddddd 

(xxxxx) ccc [s] <p{p}> 

where: 


ddddd 

Group FID (decimal). 

xxxxx 

Group FID (hex). 

ccc 

Line number that has the group locked, or an asterisk (*) 
if the group is not locked, but one or more items in the 
group are locked. 

s 

System number in an UltiNet network where the line is 
located, or an asterisk (*) for the local system (no 
network). 

p 

Line number that has a read lock in the group. 


The BASIC locks information consists of 48 fields. A field is 000 if 
unlocked. Otherwise, the field contains the line number plus 1 of the 
line that locked it. 

The system lock bytes information consists of 000 if unlocked. 
Otherwise, the field contains the line number plus 1 of the line that 
locked it. 

The line information consists of the following columns (also used by the 
WHERE command): 
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Spooler 

Information 

Available On 
See Also 


• Line number for which information is displayed. If your line number 
is displayed, it is preceded by an asterisk (*). 

• PIB status. The PIB status for each line consists of four digits. The 
first two digits are: 

00 or 80 Active, or ready to go. 

02 Waiting for terminal input. 

04 Waiting for terminal output. 

20 Waiting for disk. 

40 Release quantum/sleeping (typical of the spooler). 

The second two digits are: 

80/90 The line is in the debugger. 

Any other Normal. 

• PCB frame ID of the line, in hexadecimal. 

• T indicates tape attachment. 

d If the information came from the Debugger Control Block (DCB). 
m If the return address is delimited by a stack marker. 

• Assembly-level location counter (first address) and subroutine return- 
stack addresses. The entry format is as follows: 

fff.ooo 

where: 

fff Decimal FID. 

ooo Hexadecimal offset. 


The spooler is displayed as active or inactive. To be active, the spooler 
must have one or more print jobs actively printing on a physical printer 
device. For each printer, the display shows its type and status, job 
queues, and the number of page skips between jobs. If the printer is 
active, the report shows the print job entry number currently being printed 
on the physical printer device. 


Any user account. 

LIST-LOCKS 

WHERE 

System Management Guide for information on system concepts. 
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WHERE 

WHERE 

Syntax 

Description 
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WHERE displays the current status of any or all lines in the system. 


WHERE {'accountname'} {n{-m}} {(options) 

'accountname' Displays the line number status for the specified 
account name only. The account name must be 
enclosed in single quotes. 


n{-m) 


(options 

p 

Z 


Displays the line number status for specified line 
n or range of lines n through m. 

Routes output to the spooler. 

Displays all line numbers in the system, whether 
or not they are currently logged on. 


Note: If parameters are omitted, the status of all currently logged on 
lines is displayed. 


Use WHERE to check the status of any or all lines in the system. 

Note: To check the status of the entire system, use WHAT. 

WHERE displays the status of the specified lines. If a line is running on 
more than one TCL level, the statistics for all TCL levels are displayed. 

The report information consists of the following columns: 

• Line number for which information is displayed (if your line number 
is displayed, it is preceded by an asterisk (*)). 

• PIB status. The PIB status for each line consists of four digits. The 
first two digits are: 

00 or 80 Active, or ready to go. 

02 Waiting for terminal input. 

04 Waiting for terminal output. 

20 Waiting for disk. 

40 Release quantum/sleeping (typical of the spooler). 

The second two digits are: 

80/90 The line is in the system debugger. 

Any other Normal. 
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WHERE 


Available 
See Also 


• PCB frame ID of the line, in hexadecimal. 

• T indicates tape attachment. 

d If the information came from the Debugger Control Block (DCB). 
m If the return address is delimited by a stack marker. 

• Assembly-level location counter (first address) and subroutine 
return-stack addresses. The entry format is: 

fff.ooo 

where: 

fff Decimal FID. 

ooo Hexadecimal offset. 

WHERE displays all the entries in the return stack. If there are more 
entries than fit on one line, additional lines are used. 


: WHERE 66-73J 


066 

0210 

001880 

TO 

1141.032 

685.042 

5.0AB 

067 

2010 

005B6A 

d 

231.166 

245.054 

255.152 



0004A0 


1.0E2 

6.097 

6.032 

069 

0290 

000DC2 

d 

1153.035 

132.063 




000DC0 


1.1A6 

1141.032 

685.02F 

5.0A0 







071 

0210 

OOOFOO 

m 

1141.032 

1142.05C 

247.0D4 

*073 

8010 

001A40 


1125.045 

1125.0B8 

121.07A 


In this example, tape drive 0 is attached to line 066. Line 067 has a 
secondary TCL level at the system debugger. The workspaces being 
used by this TCL level start at frame 5B6A (in hexadecimal). 

The second display line for line 067 shows the line's first TCL level. 


On Any user account. 


SHOW-LEVELS 

STATUS 

WHAT 
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WHO 


WHO 


Syntax 


Description 


2-558 




WHO displays the specified line number and associated accountname. 


WHO {'accountname'} {n{-m}} {c} 

'accountname' Displays all line numberslogged to the specified 
account. The accountname must be enclosed in 
single quotes. 

n {- m } Displays the account names for a specified line n, 

or range of lines n through m. The line numbers 
can be any valid line from 0 to the maximum 
number of lines on the system. 

c Specifies any non-numeric character, such as * 

or &. Displays the account names for all lines 
currently logged on. 

Note: If parameters are omitted, information for the current line is 
displayed. 


Use WHO to determine which account is currently logged to one or more 
terminal lines, or to determine all lines logged to a particular account. 

WHO displays specified line number and associated name in the 
following format: 

n accountname 

where: 

n Line number, 

accountname Account logged to the line. 

If no user is logged to a specified line, the account name is displayed as 
UNKNOWN. 

If the specified accountname does not exist, the command exits and no 
report is displayed. 
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WHO 


Available 

See Also 


6985-3.2 


If the specified line number does not exist, the following error message 
is displayed: 

[1145] Illegal specification number n 


: WHO 1-50 J 

Display the accountnames logged to lines 


1 through 50. 

1 ADMINISTRATION 


2 FINANCE 


3 ACCOUNTING 


4 UNKNOWN 


5 SUPPORT 


6 ULTIMATION 


7 UW 


8 UNKNOWN 


9 DOCUMENTATION 


50 SALES 



On Any user account. 


LISTU {SERS} 
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WP-INfPUT} 


WP-IN{PUT} 


Syntax 


Description 


Available On 


2-560 


WP-IN(PUT) invokes the UltiWord word processor to create or edit 
documents. This command is an alternative to using the Word 
Processing Main Menu to access documents. 


WP-IN{PUT} filename {item-iD} {(options) 

filename Specifies the file to be created or edited. 
item-iD Specifies the item to be created or edited. 


(options 

S Suppresses display of ruler help screen on new items. 

V Displays items in View-off mode (\commands are not 

displayed). 


For further information on WP-IN(PUT), please refer to the UltiWord 
Reference Guide. 


Any user account. 
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WP-OUT{PUT} 

WP-OUT{PUT} invokes the UltiWord word processor to display or print 
a word-processing document. 


Syntax 


WP-OUT{PUT} filename {item-iD} {(options) 


filename Specifies the file containing the item to be output, 
item-ll) Specifies the item to be output. 


(options 

n Increases left margin by n spaces. 

A Routes output to AUX line. 

H Routes output to holdfile. 

L Displays output with line numbers. 

N Specifies no automatic end-of-page waiting. 

P Routes output to spooler. 

Q Formats output for letter quality printer. 

R Uses fixed formula for right justifying text. 

V Displays items in View-on mode (\ commands are 

displayed). 


Description For further information on WP-OUT{PUT), please refer to the UltiWord 
Reference Guide. 


Available On Any user account. 
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WY60 

WY60 

Syntax 

Description 


Available On 

See Also 


2-562 


WY60 sets a Wyse-60 terminal so that the cursor-left (<—) key does not 
delete the character to the left of the cursor. 


WY60 


Use WY60 to set up a Wyse-60 terminal so that it operates properly 
when the TCL stack commands are used. 

WY60 changes the operation of the cursor-left («—) key on a Wyse-60 
terminal by changing the character generated by this key into a character 
recognized by the TCL stack. All the cursor movement and editing keys 
then work on Wyse-60 terminals as documented in the Chapter 1 
description of the TCL stack. 


: WY60J 


Any user account. 


132 and 80 (columns) 

CLEAR-STACK 

SET-STACK 

TERM-INIT 

Chapter 1 of this document for information on cursor movement and 
editing keys. 
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X-OFF 


Syntax 


Description 


6985-3.2 


X-OFF disables the data-flow control on a line, which is normally used 
to prevent a buffer overflow condition. Both outgoing and incoming 
data-flow control are disabled. 


X-OFF {n} 

n Specifies the line on which data-flow control is to be 

disabled. If omitted, the current line is assumed. 


Use X-OFF to disable data-flow control. 

All Ultimate systems support both incoming and outgoing (bidirectional) 
control. The normal, default condition of data-flow control enabled 
causes the system to monitor the user’s terminal. 

Whenever the typeahead input buffer is almost full, the system 
automatically sends an X-OFF character to the terminal or other device. 
This feature allows a device such as a serial printer, which recognizes 
the X-ON/X-OFF handshaking protocol, to check data-flow for a potential 
overflow condition in its input buffer. 

When the buffer is nearing an overflow condition, an X-OFF character is 
transmitted to the Ultimate system so that the buffer can be emptied 
before receiving any more data. The Ultimate system does not send any 
more data to the device until the device transmits an X-ON character. 
When the typeahead input buffer empties and can accept more data, the 
system automatically sends an X-ON character. 

X-OFF disables this normal data-flow control for the specified line. No 
data-flow control is done by the system and overflow conditions can 
occur without notifying the user. Once X-OFF has disabled the data¬ 
flow control for a line, the line remains in that state until control is 
reinstated via X-ON, or logoff and subsequent logon. 

Disabling data-flow control allows transmission of the X-ON and X-OFF 
characters as regular data characters. Whenever data-flow control is 
enabled, these characters cannot be input as data into the system, 
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Available On 


See Also 


2-564 


because they are intercepted by the terminal controller. A device that 
follows the X-ON/X-OFF protocol does not output these characters as 
data. 

Note: X-OFF does not halt the actual data-flow, hut it halts the system 
control of the data-flow. 

The outgoing data-flow can be turned off by sending an X-OFF character 
(X'13’) and turned back on by sending an X-ON character (X'l T). You 
can send an X-OFF character by pressing <CTRL-S> . Terminal output 
then stops until you send an X-ON character by pressing <CTRL-Q> . 

If a non-existent line number is specified, the following message is 
displayed: 

[535] Illegal line number 


: x-off 3J Disable data-flow control on line 3. 


SYSPROG or SECURITY account. This command is not available on 
Ultimate S/370 or S/390 systems. 


X-ON 
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X-ON 


X-ON 


Syntax 


Description 


X-ON enables the data-flow control on a line, which is normally used to 
prevent a buffer overflow condition. 


X-ON {n} 

n Specifies the line on which data-flow control is to be 

enabled. If omitted, the current line is assumed. 


Use X-ON to enable data-flow control. The command assumes that 
control has been previously disabled on the line by X-OFF. 

All Ultimate systems support both incoming and outgoing (bidirectional) 
control. The normal, default condition of data-flow control enabled 
causes the system to monitor the user’s terminal. 

Whenever the typeahead input buffer is almost full, the system 
automatically sends an X-OFF character to the terminal or other device. 
This feature allows a device such as a serial printer, which recognizes 
the X-ON/X-OFF handshaking protocol, to check data-flow for a potential 
overflow condition in its input buffer. 

When the buffer is nearing an overflow condition, an X-OFF character is 
transmitted to the Ultimate system so that the buffer can be emptied 
before receiving any more data. The Ultimate system does not send any 
more data to the device until the device transmits an X-ON character. 
When the typeahead input buffer empties and can accept more data, the 
system automatically sends an X-ON character. 

X-ON reinstates this normal data-flow control for the specified line. If 
the line is already enabled, no action is taken. Once X-ON has enabled 
the data-flow control for a line, the line remains in that state until control 
is disabled via X-OFF. 

Note: X-ON does not start the actual data-flow, hut it allows the 

system control of the data-flow. 
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X-ON 


Available 


See Also 


2-566 


The outgoing data-flow can be turned off by sending an X-OFF character 
(X’13') and turned back on by sending an X-ON character (X'l 1'). You 
can send an X-OFF character by pressing <CTRL-S> . Terminal output 
then stops until you send an X-ON character by pressing <CTRL-Q> . 

If a non-existent line number is specified, the following message is 
displayed: 

[535] Illegal line number 


: x-on 3 J Enable data-flow control for line 3. 


On SYSPROG or SECURITY account. This command is not available on 
Ultimate S/370 or S/390 systems. 


X-OFF 
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X-REF 

Syntax 


Description 


Available On 

See Also 

6985-3.2 


X-REF creates a cross-reference listing of symbols from the CSYM file 
and stores it in the XSYM file in symbol name order. 


X-REF filename {itemlist} 

filename Usually specifies CSYM, the file where CROSS-INDEX 
puts symbol data. However, X-REF can be used with 
any file whose items are in CSYM format. 

itemlist Specifies one or more explicit item-IDs, or an asterisk (*) 
to indicate all items in the file. Can be omitted if a select- 
list is present. 


Use X-REF to create a cross-reference listing of the CSYM file, which is 
assumed to contain program name items previously created by CROSS¬ 
INDEX. 

Each symbol name associated with a program name in CSYM is stored 
as a separate item in a previously created file called XSYM. For each 
XSYM symbol item, the item-lD is the symbol name, and the only 
attribute is a multi-valued list of program names that use the symbol. In 
other words, where CSYM contains program name items that have 
symbol names as data, XSYM contains symbol name items that have 
program names as data. 


: x-ref csym *J Create a cross-reference of all programs 

in the CSYM file. Information is placed in 
a file called XSYM. 


SYSPROG or SECURITY account. 


CROSS-INDEX 

XREF 

Ultimate Assembly Language Reference Guide. 
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XREF 


XREF 


Syntax 


Description 


2-568 


XREF clears the XSYM file .executes X-REF, and produces a sorted 
listing of the new XSYM file. 


XREF {filename} {itemlist} {(options} 

filename Specifies the name of the X-REF source file, normally 
CSYM. If omitted, the system prompts for it. 

itemlist Specifies one or more explicit item-lDs, or an asterisk (*) 
to indicate all items in the file. Can be omitted if a select- 
list is present. 

(options Specifies any SORT options, or any single modifier, such 
as LPTR or NOPAGE. 


XREF is a PROC that combines the processing of CROSS-INDEX, X-REF, 
and SORT. Use XREF to create a cross-reference listing of the CSYM file 
with a sorted listing of the resulting XSYM file. Before using XREF, an 
attribute called REFERENCES must be defined in the file dictionary as 
follows: 


REFERENCES 

001 A 
002 1 

003 REFERENCES 

004 

005 

006 

007 

008 

009 L 
010 70 


Ultimate System Commands Guide 6985-3.2 

Confidential and Proprietary to The Ultimate Corp. 





XREF 


Available 

See Also 


:xref csym * (pj Print an alphabetical, noncolumnar 

listing of XSYM. REFERENCES shows the 
programs in which the symbols ABIT and 
AFare used. 

XSYM: ABIT 

REFERENCES EDIT-I EDIT-II EDIT-III 
XSYM: AF 

REFERENCES ASTAT WRAP-III EDIT-I EDIT-III 


On SYSPROG or SECURITY account. 


CROSS-INDEX 

SORT 

X-REF 

Ultimate Assembly Language Reference Guide. 
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XTD 


Syntax 

Description 

Available On 

See Also 


2-570 


XTD (Hexadecimal To Decimal) converts a hexadecimal number to its 
equivalent decimal value. 


XTD n 

n Specifies the hexadecimal number to be converted to 

decimal. 


XTD converts positive and negative hexadecimal numbers to their 
equivalent decimal values. Negative hexadecimal numbers can range 
from FFFFFFFFFFFF to 8()()()()()()()()()()1. Positive hexadecimal numbers 
can range from 0 to 7FFFFFFFFFFF. If fewer than 12 hexadecimal 
characters are entered, high order zeroes are assumed. 


: XTD FFFJ 

4095 


Any user account. 


DTR 

DTX 
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A/AMC Attribute number heading. The 

number or position of the attribute 
in the data item. 

A B S Assembler Software section. 

ACC File Accounting History File. Contains 

account usage data. 

Access Code Required on S/370 and S/390 

systems in order to use a line other 
than line zero. 

Access Permission Ability to access another account or 

a file in another account. Access is 
provided via update and retrieval 
locks. 

A collection of related files 
associated with one user or one 
function. Each account has a 
Master Dictionary. 

Loading an account to disk from a 
previously created account-save 
tape. 

Saving a disk account to tape. 

Name of an account. A user logs 
on the system by entering an 
accountname. 

A line of information in an item. 
Known as a field in other database 
systems. 

Attribute Definition Item Used to define an attribute; includes 

information on how the data is 
calculated and presented. 

Available Space, Frames remaining after all user and 

Available Space Pool other account sizes have been 

specified. 


Account 


Account-Restore 

Account-Save 

Accountname 

Attribute 
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Base, Base FID 

File location; first frame ID (FID) of 
primary storage. 

BASIC 

Beginner's All-Purpose Symbolic 
Instruction Code; a programming 
language. 

Baud Rate 

Rate at which information is 
transferred between hardware. 

Bisynchronous 

Data transmitted in two opposite 

Communication, Bisync 

directions simultaneously. 

Block (Tape) 

Unit of information on a tape. 

Block Print 

Printed characters made up of 
multiple rows of the character being 
printed. 

BMSH 

Base, modulo, separation, hashing 
algorithm. 

BOD 

Beginning of Data. 

Boot 

See Waimstart. 

Bootstrap Procedure 

See Waimstart. 

BOT 

Beginning of Tape. 

Braces 

{Punctuation marks that surround 
optional parameters). 

<BREAK> Key 

Interrupts the current process. 

<BREAK> and END 

Press the <BREAK> Key and enter 
END at the system debugger prompt 

BSC 

Bisynch(ronous) Controller. 

Bull 

See Platforms. 

CC-Pointer 

Compiled BASIC program object 
code pointer. 

CL-Pointer 

Saved list pointer. 

Charge 

Record system usage. 

Charge Name 

Account or file to which system 
usage is charged. 
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Checksum 


Calculation on the items in a file. 


Coldstart Bringing a system on-line from a 

power off state. 

Colon Prompt See TCL Prompt. 

Command Part of a TCL Command Statement. 

A command can be a verb, PROC, 
or catalogued BASIC program. 

Command Statement Contains the TCL command and any 

parameters. Executed by pressing 
the RETURN key. 

Connective Element in a RECALL statement. 


Contiguous Overflow 
Frames 

Conversion 

Correlative 

CP 


<CTRL> Key 


CTS 


Two bytes per 1K of memory. 

Affects display of item-IDs. 

Affects calculation and display of 
item-IDs. 

Control Program. CP commands 
are available only on Ultimate S/370 
and S/390 systems. 

Used with other keys to perform a 
desired action. See Editing Key 
Sequence. 

Clear To Send. 


D-Pointer 

D/Code 


DATA Section 


Default Value 


See File Definition Item. 

Code that identifies the item as a 
file-defining item or a file pointer. 
D/CODES are D, DV, DW, DX, and 
DY. 

Lowest level of a file; contains data 
stored in variable length attributes 
and items. 

Preset value for a parameter if no 
user input is provided. 
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Diagnostics 

Tests to determine hardware or 
software operation. 

DICT Section, Dictionary 

An item that contains pointers to 
data files and attribute definition 
items. 

Disk Shadowing 

Activities occurring on one disk or 
set of disks is duplicated on another 
disk or set of disks. 

Display 

Output appears on the terminal 

screen. 

DSR 

Data Set Ready. 

DTR 

Data Terminal Ready 

or 

Decimal To Radix. 

EDAC 

Error Detection and Correction. 

Echo 

When keyboard input is displayed 
on the terminal screen. 

Editing Key Sequence 

A sequence of several keystrokes, 
such as <CTRL-X>. 

Enter 

Type input, then press the RETURN 
key. 

EOD 

End of Data. 

EOT 

End of Tape. 

ERRMSG File 

File containing all system error 
messages. 

Error Message 

System response to incorrect entry 
or other processing error. 

Extended Format 

Items larger than 32 k. 

Extended Frames 

Linked frames allocated from 
available space after primary file 
space has been used up. 

Extended Workspace 

See Extended Frames. 
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FCB 

FID 

FIFO 

File 

File-Restore 


File-Save 


File-Save Tape 
Filename 


File Definition Item 


File Control Block. 

Frame ID. 

First In, First Out. 

Contains one or more items. 

Loading one or more files to disk 
from a previously created file-save 
tape. 

Saving one or more disk files to 
tape. There are three types of file- 
saves; full file-save, part update 
save, and all update save. 

A tape on which all files have been 
saved. 

Specifies the DICT section, one or 
more DATA sections, or all sections 
of a file. 

Defines and points to a file in the 
current account. Also known as a 
D- Pointer. 


File Synonym Definition Points to a file in another account. 
Item Also known as a Q-pointer. 

Frame A memory block; size is platform 

specific. 


GFE 

Greater-Than Prompt 
Group 


Group Format Error 


See Group Format Error. 

See TCL prompt. 

A collection of frames. The number 
of groups per file is determined by 
the modulo of the file. 

Error created when a group is 
updated incorrectly or incompletely. 


Hashing Algorithm 
Hexadecimal 


Determines the group into which 
items are placed. 

Base 16 numbering system. 
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hh:mm:ss 

Hold File 
Host System 


Represents values for hours, 
minutes, and seconds. 

Holds a job for the spooler. 

System to which other systems are 
linked on an UltiNet network. 


Index 


IPL 

Item 

Item-ID 


Itemlist 


A sorted set of data based on 
attributes in a file. Provides a 
permanent, pre-sorted means of 
accessing items in the indexed file. 

Initial Program Load. 

A set of related attributes; also 
known as record. 

Name by which an item is 
identified. Also known as key 
record. 

One or more explicit item-lDs, or an 
asterisk (*) to specify all items in a 
file. 


Justification The alignment of data in an item for 

display or sorting. 


Kernel 


Keyword 

Level, Level Pushing See tcl Level. 

Line Data line between the terminal and 

the system. 

Logger, Logging See Transaction Logger. 


The section of the Ultimate 
Operating System that handles 
process and disk scheduling, 
memory management, I/O, and 
interrupt handling. 

See Parameter. 
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Log Off 

- Log On 

Log To 

LPTR 

LSI 


To end a work session at a terminal 
and make it inactive. 

To start a work session at a terminal 
in a specified account. 

Specify starting another account 
without exiting the current account. 

Option to send output to the printer. 

See Platforms. 


M/DICT 

Master Dictionary 


MD 

mm/dd/yyyy 

Modulo 


Heading for the Master Dictionary. 

Contains the account's verbs, 
PROCs, and cataloged BASIC 
programs, as well as D-pointers and 
Q-pointers. 

Master Dictionary. 

Represents values for month, day, 
and year. 

Number of groups in primary 
storage; maximum is 16,777,213. 


Network 

NEWAC File 
NNCF 

NOPAGE 

NPCF 

Null Item-ID 


One or more systems connected by 
hardware and software. 

Prototype Master Dictionary file. 

Number of Next Contiguous 
Frames. 

Parameter specifying no end-of- 
page waiting. 

Number of Previous Contiguous 
Frames. 

An item-lD with no specified name. 
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Option 

One-letter Code that performs 
additional actions during a TCL 
command. Usually preceded by a 
left parenthesis, must be specified 
after all other parameters. 

Parameter 

User-specified input to an Ultimate 
command statement, such as 
filename, item-lD, or option. 

Keyword 

Parameter keyword, followed by an 
equal sign and the parameter value. 
Not position dependent. 

Positional 

Must be specified in a certain order. 

Password 

Sequence of non-echoing characters 
entered at a prompt to provide 
access to a security account or file. 

PCBF 

Process Control Block FID. First 
frame of process workspace, shown 
in hexadecimal. 

PIB 

Process Identification Block. 

Platforms 

The following platforms are 
currently supported: 

Ultimate Bull 6000/7000 and LSI 
systems. 

Ultimate IBM S/370 and S/390 
systems. 

Ultimate 1400 systems. 

Ultimate PLUS on Hewlett Packard 
9000 systems. 

Ultimate PLUS on IBM RISC 
System/6000 systems. 

Ultimate PLUS on Bull DPX/2 
systems. 

Pop 

Return to the previous TCL level. 

Port 

Obsolete; see Line. 

Print 

Output at the printer. 
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Privilege Level 


PROC 


PSYM File 
Push 


Determines amount of access to 
system commands and functions. 
Available levels are 0,1, and 2. 

Executable program written in 
Ultimate PROC procedural language. 
Can be used as an Ultimate 
command. 

Default system debugger file. 

Go to the next TCL level. 


Q-Pointer See File Synonym Definition Item. 

QFILE File Temporary Q-pointer that changes 

each time SET-FILE is executed in 
the current account. 


Reallocate, Reallocation Adjusts the space needed for files 

whose size has increased or 
decreased since being created. 

RECALL Database query language used to 

retrieve information and generate 
reports. 

Record (Tape) See Block. 


Retrieval Locks 

RETURN 

RISC 

RS/6000 


Prevents specified accounts from 
accessing information. 

The keyboard RETURN key. 

Reduced Instruction Set Code. 

RISC System 6000. See Platforms. 


S/370 and S/390 
S/AMC 


S/NAME 


See Platforms. 

Report heading for structure code if 
the attribute controls or is controlled 
by another attribute. 

Report heading for alternative item 
name. 
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Security Account 

The SECURITY account, or the 
SYSPROG account if SECURITY is 
enabled. 

Select-List 

A list of items created with one of 
the list commands. 

Separation 

Number of frames per group. 

Shadow 

To duplicate all operations being 
performed on two sets of disks. 

Sib, Sibling 

Disk drive that is being shadowed 
by another disk. 

Spooler 

Process that controls and routes 
print jobs. 

Stack 

See TCL Command Stack. 

SYSPROG 

System Programmer Account. 

SYSTEM Dictionary 

Highest level file in the Ultimate file 
hierarchy. Contains pointers to all 
accounts. 


TAC Technical Assistance Center. 

TACPAC Stand-alone diagnostics for Ultimate 

6000/7000 systems. 

TCL Terminal Control Language. 

TCL-I TCL commands that do not access 

files. 

TCL-II TCL commands that access specified 

files or items. TCL-II commands 
require that an itemlist be specified 
if no select-list is present. 

TCL Command Stack Contains TCL command statements 

as they are entered. Statements in 
the TCL stack can be displayed, 
edited, and re-executed. 

TCL Levels Multiple TCL levels can be specified 

by a line, limited only by disk 
space. Each level can execute a 
separate process. 
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TCL Prompt 
Terminal 

Transaction Logger 

UCSB 

UDS 201 C/D 

UDS 208 B/D 

UltiKit 

UltiLink 

Ultimate Plus 
UltiMation 
UltiNet 
UltiPlot 

UltiWriter 

UPDATE 

Update-Save 

Update Lock 
User Name 

Verb 


A colon (:) if the TCL stack is ON; 
otherwise a greater-than sign (>). 

Serial I/O device with keyboard and 
monitor screen on which system 
input and output is displayed. 

Utility that records each disk file 
update to tape. 


Universal Character Set Buffer. 

2400 baud autodial synchronous 
modem. 

4800 baud autodial synchronous 
modem. 

Application development 
environment. 

Asynchronous communications 
support application. 

See Platforms. 

Office automation application. 

Network support application., 

Produces graphs from database 
information. 

Function key-based word 
processor. 

Screen-oriented, on-line database 
maintenance program. 

Saves to tape all updates (creation, 
deletion, or change) since the last 
save. 

Prevents specified users from 
changing information in an account. 

See Account Name. 


TCL command written in assembly 
language. 
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VM Virtual Machine. 

X'nn' Hexadecimal value. 
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The master list of Ultimate system error and informational messages 
is found in the ERRMSG file on the SYSPROG account. These 
messages are displayed by various system software, and have no 
standard numbering system or display format. Many messages do, 
however, fall into general categories, and many are displayed with 
an identifying number. 

The table below summarizes the general message categories in message 
number order (which is also the item-id order) for easier user reference. 
Messages displayed without numbers are also included (in item-id 
order). Displayed message numbers are enclosed in square brackets 
(for example, [89]), while message numbers not displayed are shown 
with no brackets (for example, 2). 

Note: To print a sorted list of error messages, enter SSELECT 

ERRMSG, then PRINT-ERR ERRMSG (P. 


Message Category 

Range of Numbers 

Recall and other system 
command entry errors 

2, and [3] through [120] 

Bisync command processing errors 

[121] through [151] 

Recall command entry errors 

[151] through [173] 

System command entry errors 

[197] through [204] 

System Assembler errors 

[205] through [219] 

Editor messages 

220 through 223 

System Assembler errors 

[225] through [238] 

System command messages 

[239] through [260] 

PROC command processing errors 

[265] through [281] 

System command messages 

[282] through [431] 

Transaction Logger messages 

451 through 466 

System command messages 

520, [521] through [558] 
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Message Category 

Range of Numbers 

Bisync error messages 

600 through 620 

Recall command entry errors 

[700] through [708] 

Tape and Disk errors 

720 through 753 

System command messages 

780 through 806 

A sync command entry errors 

[911] through [913] 

Dump command entry errors 

[990] through [991] 

Restore command entry errors 

[992] through [994] 

What command messages 

998 through 999 

Spooler message 

[1004] through [1243] 

Printer Diagnostics messages 

1250 through 1256 

Disk Diagnostics messages 

1257 

Memory Diagnostics messages 

1259 through 1260 

UltiNet error messages 

[2001] through [2341] 

Recall forms output 
command entry errors 

[5001] through [5012] 

Update command entry errors 

[7001] through [7134] 

Basic command entry errors 

B0, [Bl] through [B220] 

UltiPlot error messages 

[G1 ] through [G94] 

UltiWord error messages 

WP-E1 through WP-E5 
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Error Message Format 

Each line in an ERRMSG item must conform to the following general 
format: 

code(text) 

The valid codes are: 

A Inserts the next parameter from the list of parameters 

passed by the originating process. 

A (n) Inserts the next parameter as above, but left justified in a 
field of 'n' blanks. 

AM Inserts attribute mark. 

D Inserts the current date. 

E Inserts the item-lD enclosed in brackets. 

H Inserts the text following the H; does not include a 

CR/LF. 

H + Suppresses final CR/LF that is normally output; used at 

the end of the ERRMSG item. 

L Prints the contents of the output buffer with CR/LF at the 

end. 

L(n) Same as L, then outputs n-1 blank lines. 

R (n) Inserts the next parameter as A (above), but right 

justified in a field of 'n' blanks. 

S(n) Sets the output buffer pointer to location 'n'. 

T Inserts the current time. 

X Skips a parameter in the list of parameters passed by the 

originating process. 
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This appendix presents a list of ASCII codes for decimal number values 
from 0 through 127 and 251 through 255. The hexadecimal equivalent 
value and ASCII character generated are also given. 

Decimal values 0-31 are assigned as non-printable functions; these 
codes may be specified by control key sequences as input to a BASIC 
program. In the listing, the control key is indicated by a caret ( A ) in the 
first position in the Key column. 

Decimal values greater than 127 (x'7F’) are not defined in the ASCII 
character set. The functions or characters assigned to these values are 
dependent on the terminal being used. However, special file structure 
functions and control key sequences have been assigned to decimal 
values 251 through 255 (x'FB’ through x'FF'). 
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Decimal _ Key _Hexadecimal Name 


0 

A @ 

00 

NUL 

1 

A A 

01 

SOH 

2 

A B 

02 

STX 

3 

A C 

03 

ETX 

4 

A D 

04 

EOT 

5 

A E 

05 

ENQ 

6 

A F 

06 

ACK 

7 

A G 

07 

BEL 

8 

A H 

08 

BS 

9 

A I 

09 

HT 

10 

A J 

0A 

LF 

11 

A K 

OB 

VT 

12 

A L 

OC 

FF 

13 

A M 

OD 

CR 

14 

A N 

OE 

SO 

15 

A 0 

OF 

SI 

16 

A P 

10 

DLE 

17 

A Q 

11 

DC1 

18 

A R 

12 

DC2 

19 

A S 

13 

DC3 

20 

Ay 

14 

DC4 

21 

A U 

15 

NAK 

22 

A V 

16 

SYN 

23 

A W 

17 

ETB 

24 

A X 

18 

CAN 

25 

A Y 

19 

EM 

26 

A Z 

1A 

SUB 

27 

A l 

IB 

ESC 

28 

A \ 

1C 

FS 

29 

A ! 

ID 

GS 

30 

AA 

IE 

RS 

31 

A 

IF 

US 
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ASCII Codes 


Decimal 

Hexadecimal 

Symbol 

Name 

128 (x'8()’) 

thru 250 (x'FA 1 ) 

not used 


251 

FB 

SB 

Start buffer 

252 

FC 

SVM 

Subvalue Mark 

253 

FD 

VM 

Value Mark 

254 

FE 

AM 

Attribute Mark 

255 

FF 

SM 

Segment Mark 


CA 
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S/370 and S/390 UCSB and FCB 
Items 


The Ultimate S/370 and S/390 system support for parallel printers 
requires that a Universal Character Set Buffer (UCSB) item be defined 
and loaded before the printer is used. 

An additional item called the Forms Control Buffer (FCB) can be defined 
that allows paging characteristic to be changed. 

The UCSB defines the print train, and when loaded, sets up a default 
ASCII-to-EBCDIC translation table for the printer. The translation table 
may be modified by adding mapping specifications to the UCSB item. 

Print trains and mapping specifications are defined as items in the UCSB- 
DEF file on the SYSPROG account; there are items defined for the 1403, 
3211, 3203, 4248, 6262, 4245, 3262, and various other printers. The 
names of 1403 print train items end with the number 14; for example, 
PN14. For more information about print trains and the UCSB, refer to the 
IBM component description for your printer. 

The following is an example of a UCSB item; 
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001 * UCSB comment field 

002 304 

- length of print train image and 

003 240 

optional DUCT table (printer & train dependent) 

- length of print train image. 

004 

- 

005 

- attributes 5 through 244 (in this example) 

• 

contain print train images. 

244 

245 

- DUCT (for printers that support 


this) 

307 

308 * Comment about optional mapping section 

309 1 

- number of mapping pairs. 

310 21 6F 

- map CT to E'?' 


Loading the UCSB 


The UCSB is loaded as part of the SP-STARTLPTR command. As part of 
the coldstart procedure, the Ultimate system automatically starts the first 
parallel printer on the system using the UCSB-DEF item called 
STANDARD. The item STANDARD should be loaded with the appropriate 
print train definition for your parallel printer. 

If there is no item STANDARD, an error message is displayed and the 
coldstart continues. When the system is up, use SP-STARTLPTR to start 
your printers, or add an SP-STARTLPTR with the appropriate UCSB item 
to USER-COLD-START. 
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FCB Format for 6262 and 4248 Printers 

The following FCB item format is used to define 6262 and 4248 printers: 


Attribute Description 

1 * (asterisk) followed by any comments 

2 type; for 6262 and 4248 printers, if added form control 
features are to be defined, specify 2; if added features are 
not used; can be 1 

3 index; ignored by 6262 and 4248 printers 

4 lines per inch (lpi); to specify more than one value per 
page, separate values with a value mark 

5 first line to print using corresponding lpi value; separate 
values with a value mark 

6 number of lines per page 

7 LEVEL=x, stacker level control, where x is a value from 
0 to 3 as follows: 

0 automatic control 

1 1 inch below automatic level 

2 2 inches below automatic level 

3 3 inches below automaric level 

8 SPEED=x, print speed, where x is a value from 0 to 3 as 
follows: 

0 no change from speed set by last SP-STARTLPTR 

1 slow - highest print quality 

2 medium 

3 fast - lowest print quality 

9 THlCKNESS=x, thickness of form, where x is a value 
from 0 to 3 as follows: 

0 .5 mm 

1 .2 mm 

2 .1 mm 

3 <. 1 mm 

10 OFFSET=x, horizontal copy feature, where x is position 

(given as the number of characters from the left margin) 
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that the copying is to start. If x is 0, the horizontal copy 
feature is set to off. 


Attributes 7 through 10 are optional, but, if used, must be in the order 
shown. If any one is used, all preceding optional attributes must be 
defined. For example, if you wish to define speed (attribute 8), you 
must also define level (attribute 7). 

The following are examples of two FCB-DEF items supplied with this 
revision: 


FCB6-424 8 

001 *THIS IS THE DEFAULT 4248/6262 FCB 6 LINES/IN. 

MEDIUM SPEED, AUTO STACKER. 

002 2 

003 0 

004 6 

005 1 

006 66 
007 LEVEL=0 
008 SPEED=2 
009 THICKNESS=0 
010 OFFSET=0 


FCB6-VARIABLE-4 24 8 

001 *THIS IS A SAMPLE 4248/6262 FCB WITH VARIABLE 

LINE SPACING; LINE SPACING CHANGES EVERY 5 INCHES 
002 2 
003 0 

004 6]8]6 

005 1]30]70 

006 76 
007 LEVEL=0 
008 SPEED=2 
009 THICKNESS=0 
010 OFFSET=0 

Note: The ] character in the example is a value mark (ASCII 253). 


D-4 


Ultimate System Commands Guide 

Confidential and Proprietary to the Ultimate Corp. 


6985-3.2 



S/370 and S/390 UCSB and FCB Items 


6985-3.2 


UCSB Format for 6262 and 4248 Printers 


The following UCSB item format must be used to define 6262 and 4248 
printers: 


Attribute Description 


1 * followed by any comments 

2 BAND ID=xxxx, where xxxx is the ID of the print band 
for this printer; the print band IDs are given in your 
printer manual. This must be specified. The specified 
band id is checked by the system against the band id of 
the printer 

3 TRAIN IMAGE - must be specified exactly as shown 

4 length of print chain image (in decimal) 

5 length of print chain image (must match attribute 4) 


6-nnn print chain image, where nnn is last attribute in image; 

each attribute is the hexadecimal value of one character 


nnn+1 TRANSLATE OVERRIDE - if optional mapping pairs are to 
be defined, this phrase must follow last attribute in print 
chain image 

nnn+2 number of optional mapping pairs to follow 

nnn+3 first optional mapping pair; ASCII hexadecimal value is 
given first, followed by EBCDIC value to translate to 


The following is an example of a USCB-DEF items supplied with this 
revision: 


B64-6262-TRANSLATE 

001 *6262 64 CHARACTER EBCDIC BAND PART NUMBER 

6475399 FEATURE CODE 9501 
002 BAND ID=OE01 
003 TRAIN IMAGE 
004 64 

005 64 

006 4A 
007 4B 


069 F9 
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070 TRANSLATE OVERRIDE 

071 4 

072 21 4F 

073 5B 4F 

074 5D 5F 

075 5C 4F 
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The CAPTURE subroutine uses the PASSTHRU command and captures its 
output. After setting up the INPUTS below, CAPTURE can be called from 
BASIC with the following CALL statement: 

CALL CAPTURE (PORT,BAUD, PASSFILE, ITEMS, SIZE,KEY,ERRMSG) 

Note: When CAPTURE is called as a subroutine, your local terminal 
operates in PASSTHRU mode until you press <ESC-X>. Only 
then does the calling process return to the mainline BASIC 
program. 

The CAPTURE subroutine performs the following EXECUTE statement: 

EXECUTE "PASSTHRU PORTBAUD, //OUT. >OUTPUT 


This statement captures data passed from another terminal and maintains 
statistics using the following interfaces: 



Variable 

Description 

Inputs: 

PORT 

Line number to use for PASSTHRU. 


BAUD 

Baud rate to use for PASSTHRU. 


PASSFILE 

File variable of the file data section in 
which captured data is to be filed. 

Outputs: 

ITEMS 

Total number of items of captured data. 
Each item is approximately 10,000 bytes. 


SIZE 

Total number of bytes of captured data. 


KEY 

Captured data identifier. Each item of 
captured data has the format KEY-#, 
where: 

KEY PORT*TIME* DATE 

# Sequential number of the item, 

starting with 1 (KEY-1) and ending 
with the value in ITEMS (KEY-n). 


ERRMSG 

ERRMSG number that terminated 


PASSTHRU. 
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#CP 2-2 
. (period) 2-6 
132 and 80 2-8 
132-column format 2-8 
24-hour clock 
displaying 2-129,2-519 
setting 2-375 
with SLEEP 2-378 
2780 format 2-301,2-529 
3270-type terminal 2-506 
3270.PFK 2-9 
3780-format 2-301,2-528 

7- bit ASCII character 2-342, 2-424 

8- bit transparent data 2-342, 2-424 
80-column format 2-8 
%CFILE 2-102 

%RFILE 2-102 
%SP-KILL 2-3 
%SP-LISTQ 2-4 
%SP-STARTLPTR 2-5 
%TEMP% item 2-167 
:ACTIVATE-LINES 2-11 
:DEBUG-PSYM 2-12 
•.DUMP-MODULE 2-13 
rDUMPTAPE 2-14 
:FILELOAD 2-15 
:INIT-SYSTEM 2-19 
:MDUMP 2-20 
:RESTART-BSC 2-21 
:RESTARTLINE 2-22 
:SET-MAX-LINES 2-23 
:ST ARTSPOOLER 1-24 
:STARTSYSTEM 1-21 
:STARTVTERM 1-21 
:TASKINIT 2-26 
:TRAP 2-28 
: UNTRAP 2-29 
rWARMSTART 2-30 


:WARMSTOP 2-31 
:ZLINKED 2-32 
(filename 2-162 
(options 2-1 
<BACKSPACE> 1-12 
<BREAK> 

compared to LOGOFF 2-242 
<CTRL-C> 2-70 thru 2-71 
disable 2-72 

during DISK-FORMAT 2-142 
during S/1-LOAD 2-335 
enable 2-73 
inhibit at logon 2-110 
on 3270 terminals 2-9 

<BREAK> and END 2-247, 2-264, 2-268, 2-270, 
2-302,2-378,2-531 
<CLEAR> 2-9 
<CTRL-3> 2-512 
<CTRL-C> 2-70 thru 2-73 
<CTRL-E> 1-12 
<CTRL-H> 2-372, 2-504 
<CTRL-I> 2-489 
<CTRL-0> 2-183, 2-363 
<CTRL-P> 2-362 
<CTRL-Q> 2-564, 2-566 
<CTRL-R> 2-258 
<CTRL-R> 1-12 
<CTRL-S> 2-564,2-566 
<CTRL-W> 1-12 
<CTRL-X> 1-12 
<DEL> 1-12 
<F1> 1-12,2-75 
<F4> 1-11 
<HOME> 1-12,2-75 
<SHIFT-F1> 1-12 
<TAB> 1-12 
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Index 


- A - 

A/AMC 2-213,2-320 

ABS 2-168,2-253, 2-314, 2-423, 2-554 

ABS-DUMP 2-33 

ACC file 2-78,2-210 

access another system 2-276 

access another terminal 2-511 

ACCESS-CODE 2-35 

ACCESS-MAINT 2-37 

account name 2-78, 2-219 

account synonym 2-106 

ACCOUNT-RESTORE 2-40 

ACCOUNT-SAVE 2-46 

account-save tape 2-48, 2-311,2-350 

accounting option 2-78 

accounting statistics 2-93, 2-246, 2-263 

accountnamc 2-40, 2-246 

ADDD 2-49 

ADDS Regent 25 2-373, 2-505, 2-509 

ADDS Regent 40 2-372, 2-504, 2-509 

ADDS Viewpoint Color 2-372, 2-504, 2-509 

ADDX 2-50 

align forms 2-409 

alignment mode 2-410 

ALL-ACCOUNT-RESTORE 2-51 

ALL-UPDATE-SAVE 2-56 

alternate sector 2-139,2-141 

alternate track 2-139 

ANSI 2-463,2-465,2-475 

arithmetic calculations & conversions 1-14 

AS 2-59 

ASCII 2-323,2-475 
backspace 2-372, 2-504 
characters 2-66,2-156,2-269 
codes C-l 
format 2-415 
mode 2-457 
ASM 2-60 
assembler 1-14 

assembly code operations 2-348 


assembly language object code 2-261 

assembly language program 2-59, 2-251,2-425 

assembly language program mode (item) 2-253 

assembly-level addresses 2-369 

assembly-level location counter 2-557 

asynchronous communication 2-354 

ATP 2-113 

attribute 2-104, 2-116 

attribute definition item 2-320 

attribute definition type 2-213 

attribute mark ( A ) 2-473,2-486 

attribute name 2-422 

attribute number 2-192, 2-213, 2-320 

automatic modulo calculation routine 2-118 

available disk space 2-282 

available on 2-1 

available space 2-282 

- B - 

B-ATT 2-61 
B-DET 2-63 
B-LIST 2-64 
backslashes (\) 2-363 
backward-release compatible 2-46 
bar graph 2-280 
base 2-68,2-117 
BASIC 1-14,2-65,2-385 
debugger (*) 2-493 
lock table 2-88 
locks 2-88,2-554 
named COMMON areas 2-199 
object code 2-65, 2-97,2-130,2-158 
program 1-3,2-329 
source program 2-65,2-97 
baud rate 2-354, 2-512 
Beginner s Guide to Ultimate xii 
beginning-of-tape (BOT) mark 2-460,2-479 
billing cycle 2-87 
bisynchronous (bisync) 1 -1, 1-14 
attaching 2-61 


(O 

xM / 
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attachment table 2-64 

communication protocol 2-137, 2-300, 2-529 
controller (BSC) 2-61 thru 2-64 
detaching 2-63 
disconnecting 2-137 
dialing 2-74 
receiving 2-300 
resetting 2-21,2-77 
time outs 2-77 
transmitting 2-529 
bits per inch (bpi) 2-457 
block size 2-456, 2-459 
BLOCK-PRINT 2-66 
BMSH 2-68 
BOOT-DUMP 2-69 
bootstrap 2-30 
BREAK-CHR-OFF 2-70 
BREAK-CHR-ON 2-71 
BREAK-KEY-OFF 2-72 
BREAK-KEY-ON 2-73 
BSC-DIAL 2-74 
buffer overflow 2-563, 2-565 
BUILD-PROC 2-75 

- c - 

CAPTURE E-l 

Carrier Detect (CD) 2-293, 2-365 

CATALOG 2-76 

cataloged program name 2-130 

CC-pointer 2-99, 2-131,2-163, 2-311, 2-350 

change a filename 2-307 

CHANGE-BSC-TIMER 2-77 

channel 2-138 

channel address 2-140,2-143,2-440 

character ID 2-520 

character length 2-355 

character string 2-344 

character translation 2-526 thru 2-527 

characters per inch 2-182 

characters per line 2-286 


charge name 2-78 
charge session 2-78 
charge units 2-80, 2-82 
CHARGE-TO 2-78 
CHARGE-UNITS 2-80 
CHARGES 2-82 
charging system usage 1 -15 
CHECK-SUM 2-83,2-549 
CHECK.REV 2-84 
CHK-SYSGEN 2-85 

CL-pointer 2-99, 2-131, 2-163, 2-311,2-350 
CLAIM 2-86 

Clear To Send (CTS) 2-153, 2-292, 2-293, 2-365 
CLEAR-ACC-FILE 2-87 
CLEAR-BASIC-LOCKS 2-88 
CLEAR-FILE 2-89 
CLEAR-INDEX-LOCKS 2-90 
CLEAR-NAMED-COMMON 2-91 
clear-scrccn character sequence 2-371,2-503 
CLEAR-STACK 2-92 
CLEAR-VTERM-LOCKS 1-21 
COFF 2-93 

coldstart 2-185, 2-424, 2-545, 2-549 
COLDSTART 2-94,2-544 
colon prompt 1-13 
COMMAND 1-3, 1-7, 2-1 
COMMAND NAME 2-1 
COMPARE 2-95 
COMPILE 2-97 

compiled BASIC object code 2-131 

compiled BASIC program 2-76 

compiled BASIC program object code pointers 2-99 

computer usage 2-80 

concatenation 2-325 

connect time 2-82, 2-93 

connectives 2-212 

contiguous space 2-282 

conversion 2-117, 2-122, 2-213, 2-321,2-325 

COPY 2-98 

COPY-FILES 2-101 

COPY-LIST 2-103 
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correlative 2-117, 2-122, 2-192, 2-213 
COUNT 2-105 
CP commands 2-2 
CP facility of VM 2-2 
CPU control panel 2-30 
CPU time 2-436 
CPU units 2-93 
create boot tapes 2-113 
CREATE-ACCOUNT 2-106 
CREATE-BOOT 2-113 
CREATE-FILE 2-115 
CREATE-INDEX 2-124 
CROSS-INDEX 2-126 
cross-reference listing 2-567 
CSYM file 2-567 thru 2-568 
CT 2-127 

current spooler assignments 2-383, 2-396 
cylinder number 2-138 

- D - 

D-pointcr 2-46,2-89,2-99,2-131,2-134,2-162, 
2-170, 2-294, 2-296, 2-306 thru 2-307, 2-350 
See also File Definition hem 
D/CODE 2-336 thru 2-338, 2- 359 
data communications 2-301 
DATAdataname 1-4 
DATA dictname,datanamc 1-4 
data section 2-89, 2-115 thru 2-116, 2-134 
data section attributes 2-119 
DATA section 1-4 

data set ready (DSR) 2-248, 2-293, 2-309, 2-365 
data terminal ready (DTR) 2-61,2-93, 2-137, 2-152, 
2-291 thru 2-292, 2-309, 2-365 
data-flow control 2-563,2-565 
database backup, restore, and verification 1-15 
database entry 

Ultimate UPDATE commands 1-15 
database query 

Ultimate RECALL commands 1-15 
dataname 1-4 
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DATE 2-129 

DEC letter-quality printers 2-182 

DECATALOG 2-130 

decimal integer 2-49, 2-150, 2-259, 2-426 

decimal to hex (DTX) 2-155 

decimal to radix (DTR) 2-154 

default communication formal 2-342 

default symbol file 2-12 

default TCL stack settings 1-9 

DELETE 2-131 

DELETE-ACCOUNT 2-132 

DELETE-FILE 2-134 

DELETE-INDEX 2-135 

DELETE-LIST 2-136 

delete a logical printer 2-388 

dequeue a print job 2-389 

description 2-1 

destination account 2-255 

destination file 2-333, 2-350, 2-425 

destination frame size 2-17 

destination tape drive 2-463 thru 2-464 

detach a tape drive 2-466 

diagnostic testing 2-264 

diagnostics 1-1,1-15 

dial-upline 2-291 

DICT dictname, dataname 1-4 

DICT dictname 1-4 

DICT section 2-101, 2-134 

dictionary section 2-89, 2-115 thru 2-116, 2-134 

dictionary section attributes 2-119 

DICTIONARY section 1-4 

dictname,dataname 1 -4 

Digital VT100 2-372, 2-504, 2-509 

Digital VT200 Series 8-bit mode 2-372, 2-504 

Digital VT241 Color Graphics CRT 2-372, 2-504 

DISCONNECT 2-137 

disk address 2-138 

disk drive operation and control 1-16 

disk error 2-202 

disk I/O chain 2-265 

disk problems 2-421 
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disk shadowing 2-143 
disk status bits 
D_FLAG bits 2-146 
D_STATE bits 2-146 
disk lest 2-265 
DISK-ADDRESS 2-138 
DISK-FORMAT 2-140 
DISK-RESYNC 2-143 
DISK-STATUS 2-146 
DISK.COPY 2-148 
DISK.DIAGS 2-149 
display the stack contents 1-11 
DIVD 2-150 
DIVX 2-151 

document creation & maintenance 1-16 

double quotes (") 1-3,2-363 

DROP-DTR 2-152 

DROP-RTS 2-153 

DTR 2-154 

DTX 2-155 

dummy parameters 2-285 
DUMP 2-156 
DV 2-47,2-170,2-336 
DW 2-170,2-336 
DX 2-47,2-170,2-336 
DY 2-170,2-336 

- E- 

EBASIC 2-158 

EBCDIC 2-319 thru 2-320, 2-323, 2-411,2-415, 
2-457, 2-475 
ECHO-OFF 2-159 
ECHO-ON 2-160 
ECOPY 2-161 

EDAC error 2-268, 2-270, 2-453 

EDIT-LIST 2-165 

editing key sequences 1-7 

editor wild card character ( A ) 2-6,2-550 

ED{1T} 2-164 

EEDIT 2-166 


cnd-of-data (EOD) 2-462, 2-469,2-479 thru 2-480 
cnd-of-filc (EOF) 2-267, 2-339, 2-350, 2-460,2-464, 
2-469, 2-471,2-484 
ERRMSG file 2-285, 2-549, B-l 
Error Detection and Correction (EDAC) 2-202 
error message 1 -7, 2-285 
error reporting and recovery 1-16 
escape code 2-276 
EXCHANGE 2-167 
exclamation point (!) 2-250, 2-257 
exit character 2-511 thru 2-512 
extended formal item 2-46 
extended frames 2-172 
extended levels 2-26 
extended workspace 2-184 
extended workspace size 2-553 

- F - 

FID 2-138, 2-156, 2-172, 2-175, 2-180, 2-282 
file and account creation and maintenance 1-16 
File Control Block (FC’B) 2-216 
File Control Buffer (FCB) 2-411 
file definition code 2-215 thru 2-216 
file definition item 2-89, 2-99, 2-131,2-134, 2-162, 
2-170, 2-215 thru 2-216, 2-299,2-336 See also 
D-pointer 

file location 2-215, 2-217 
file reallocation 1-16 

file save option 2-110, 2-117, 2-120, 2-336 
File Statistics Report 2-187, 2-189, 2-207, 2-297 
file synonym definition item 2-102, 2-131,2-134, 
2-216, 2-307, 2-359 See Q-poinier 
FILE-SAVE 2-168 
file-save processes 2-336 

file-save tape 2-15, 2-40, 2-56, 2-168, 2-221,2-275, 
2-311,2-350 
filename 1-3 
FILEOPT 2-170 
firmware 2-314 
First In First Out (FIFO) 1-10 
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FIX-FILE-ERRORS 2-172 
flag settings 2-523 
foreign keyboards 2-520 
format 2-140 

i 

forms alignment 2-406 

Forms Control Buffer (FCB) 2406 

frame 2-138 

FRAME operation code statement 2-253,2-261 
frame size 2-295 
function keys 2-362 

- G - 

GCR tape drives 2-457 
GET-LIST 2-174 

Graphing (UltiPlol Commands) 1-16 
greater-than sign (>) 1-2, 1-9,2-13 
group 2-56,2-172,2-175 
Group Format Errors (GFEs) 2-19, 2-31,2-172, 
2-175, 2-187, 2-190, 2-202 thru 2-203, 2-221, 
2-275,2-336 

group lock 2-197, 2-444, 2-554 
group-updated flags 2-56, 2-168,2-275,2-337 

- H - 

HASH-TEST 2-177 

hashing algorithm 2-68, 2-115 thru 2-116, 2-120, 
2-217, 2-542 
head number 2-138 
Healhkit 2-372, 2-504 
Hewlett-Packard LaserJet printer 2-286 
hexadecimal communications status 2-293 
hexadecimal format 2-156 
hexadecimal number 2-50,2-151,2-260,2-427 
high order zeroes 2-50, 2-151,2-260, 2427,2-570 
hold file 2-383 thru 2-384,2-389 thru 2-393, 2-395 
Honeywell (NEC) letter quality printer 2-286 
Honeywell VIP-7200 2-372,2-504,2-509 
host system 2-38 
HP 700/92 2-373,2-505 

index-6 


hung line 2-22 

- I - 

IBM 3101 2-372,2-504 

IBM 3270 terminal 1-9, 2-9, 2-247, 2-372, 2-504 

IBM native system 2-492 

IBM Personal Computer 2-372, 2-504,2-509 

IBM system under VM 2-492 

IBM-specific commands 1-17 

incremental saves 2-56 

index 2-90, 2-124, 2-135, 2-194 

index key structure 2-124 

index lock 2-90,2-192 

indexed attribute 2-125 

indexing 1-17 

INIT-NET 2-178 

Initial Program Load (IPL) 2-35, 2-433, 2-440 

initialized TCL levels 2-2617 

input lab stops 2-488 

input translation 2-527 

input/output (I/O) 276 

ISTAT 2-179 

ITEM 2-180 

item handling 1-17 

item lock 2-197,2-445,2-554 

ilcm-ID 1-3 

item-size errors 2-208, 2-547 
item list 2-161 thru 2-162, 2-170, 2-180, 2-251, 
2-253, 2-261,2-285, 2-290, 2-319, 2-330, 2-343 
thru 2-344, 2-350, 2-425 

- J/K - 

job queue 2-389,2409,2413,2-555 

job queue number 2-384, 2-398, 24(X), 2-406 

justification 2-117, 2-122 

kernel 2-15, 2-30, 2-143, 2-168, 2-202, 2-314, 

2-432 

kernel commands 1-17 

keywords 1-5, 2-362, 2-367, 2-412, 2-456 
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LA100 2-182 

language setting 2-361 

length 2-117,2-122 

level popping 1-13 

level pushing 1-13, 1-17 

LEVEL-EXIT 2-183 

line 0 (zero) 2-23, 2-28, 2-35 

line editor 2-166,2-195, 2-303, 2-330, 2-381 

line graph 2-280 

line length 2-366 

line number status 2-556 

line printer 2-366 

line printer pages 2-82 

lines per inch 2-182 

lines per page 2-182, 2-286, 2-289, 2-366 

LINK-WS 2-184 

linkage process 2-184 

linked frames 2-554 

linked space 2-282 

LIST 2-186 

list handling 1-17 

LIST-FILE-STATS 2-187 

LIST-GFE 2-190 

LIST-INDEX-LOCKS 2-192 

LIST-INDEXES 2-194 

LIST-ITEM 2-195 

LIST-LABEL 2-196 

LIST-LOCKS 2-197 

LIST-NAMED-COMMON 2-199 

LIST-PLOT-DEVICES 2-200 

LIST-SYSTEM-ERRORS 2-202 

LIST-UERRORS 2-205 

LIST-UITEMS 2-206 

LIST-VSAVE-STATS 2-207 

LISTACC 2-210 

LISTCONN 2-212 

LISTDICT 2-213 

LISTF 2-215 

LISTFILES 2-216 


listing utilities 1-18 
listnamc 2-174 
LISTPROCS 2-218 
LISTU(SERS) 2-219 
LISTVERBS 2-220 
LOAD-STATS 2-221 
LOAD-TERMDEF 2-223 
local 2-276 
LOCK-FRAME 2-224 
locks 2-19 
LOG 2-225 
log to 2-246 
LOG-STATUS 2-240 
LOGGER 2-241 

logger main menu 2-226, 2-230, 2-235, 2-237 
logger status line 2-227 
logger terminal 2-225 
logging on/olT 1-18 

logical printer 2-388, 2-395, 2-398, 2-405 thru 
2-406, 2-408, 2-412 thru 2-413 
LOGOFF 2-242 
LOGON 2-244 
logon monitoring 2-348 
logon PROC 2-493 
logon violations 2-348 
LOGTO 2-246 
LOOP-ON 2-247 
LSI 11 systems 2-355 
LSI systems 2-61,2-470, 2-492 

- M - 

M/DICT 2-213 

machine-check errors 2-202, 2-203, 2-453 
macro expansions 2-251 
mailing labels 2-196, 2-382 
map of alternate areas 2-141 
Master Dictionary (MD) 1-8, 2-110,2-130, 2-132, 
2-134, 2-216, 2-220, 2-306 thru 2-307, 2-331 
maximum number of lines 2-23 
maximum number of TCL levels 2-376 
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MEM.DIAGS 2-249 

memory address 2-269 

memory buffer 2-224 

memory errors 2-269 

memory test 2-267 

memory-locked frame 2-224, 2-536 

menu of spooler command options 2-403 

message 2-250,2-257 

MESSAGE 2-250 

Minitcl 2-372,2-504 

MLCP (Multi-Line Communications Processor) 
2-453 

MLCP channel errors 2-202 
MLIST 2-251 
MLOAD 2-253 
modem 2-276 
modulo 2-68 

automatic calculation 2-115, 2-117 thru 2-118, 
2-542 thru 2-543 

automatic reallocation 2-40, 2-43 thru 2-44, 2-53 
thru 2-54, 2-284, 2-294 thru 2-298 
default 2-68, 2-107, 2-115, 2-120 
display 2-68, 2-115, 2-215, 2-217 
modulo adjustment 2-15, 2-40, 2-51,2-311 
MOVE-FILE 2-255 
MSG 2-257 
MULD 2-259 
multi-disk system 2-148 
multiple tape drive system 2-458 
MULX 2-260 
MVERIFY 2-261 

- N - 

name 2-215 

named COMMON areas 2-91 
negative decimal 2-49 
network 1-18 

new-page condition 2-371,2-503 
NEW AC 2-111 

null item-ID ("") 2-103, 2-136, 2-340 


number of next contiguous frames (NNCF) 2-156 
number of previous contiguous frames (NPCF) 
2-156 

- o - 

object item errors 2-208,2-547 
OFF 2-263 
old label format 2-458 
ON-LINE-DIAGS 2-264 
OPT 2-271 

option parameter 1-3, 1-6 
output Uib stops 2-488 
output translation 2-527 
overflow space 2-86, 2-294 

- P - 

p o_27? 

page depth 2-366 
page format 2-366 
page width 2-366 
PAGEIO-OFF 2-273 
PAGEIO-ON 2-274 

parallel printer 2-269, 2-288, 2-389, 2-407 

parameter 1-3,1-7 

parentheses 1-3 

parity bit 2-355 

parity errors 2-462 

PART-UPDATE-SAVE 2-275 

passthrough 2-276 

PASSTHRU 2-276 

password 2-41,2-47, 2-246 

PCB-FID 2-553 

performance monitor 2-430 

permanent access code 2-35 

permanent select-list 2-340 

PertecFS 1000 tape drive 2-457438 

PF keys 2-9 

physical printer 2-395,2-406,2-413,2-555 
PIB status 2-555 thru 2-556 
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PIE 2-278 
pie chart 2-278 
pitch 2-182 
planned shutdown 2-31 
PLOT 2-280 

POINTER-FILE 2-136,2-174,2-340 
pop 2-183 

POP function key 2-183 

positional parameters 1-5, 2-362, 2-367, 2-456 

POVF 2-282 

previous TCL level 2-183 

primary TCL level 2-183 

PRIME 2-284 

prime number 2-284, 2-294 

print job 2-400, 2-404 thru 2-405, 2-414 

print job entry number 2-413,2-545 

print job status 2-401 

print spooler operation and control 1-18 

print train 2-410 

PRINT-ERR 2-285 

PRINTER 2-286 

printer characteristics 2-182, 2-286 

printer test 2-269 

printer-code 2-286 

PRINTER.DIAGS 2-288 

printing terminals 2-489 

PRINTRONIX 2-289 

Printronix printer 2-280, 2-289 

PROC 1-3, 1-18, 2-75, 2-247, 2-331, 2-545, 2-568 

Process Control Block (PCB) FID. 2-219 

processing status 2-423 

PROCLIB file 2-218 

procname 2-331 

PROCs 2-218 

PSYM 2-12,2-369 

- Q . 

Q-pointer 2-46, 2-47, 2-102, 2-106, 2-111,2-131, 
2-132, 2-134, 2-216, 2-255, 2-256, 2-306 thru 


2-307, 2-351,2-352, 2-359, 2-432 See also File 
Synonym Definition Item 
QFILE 2-359 
QSELECT 2-290 

- R - 

radix 2-154,2-328 
RAISE-DTR 2-291 
RAISE-RTS 2-292 
read lock 2-197, 2-445, 2-554 
READ-STATUS 2-293 
REALLOC-FILE 2-294, 2-296, 2-298 
reallocate 2-295 
REALLOCATE 2-294 
reallocation parameters 2-123, 2-298 
RECALL commands 1-9 
RECEIVE 2-300 
receivc-data mode 2-342 
RECEIVED-MSGS file 2-300 
receiver 2-250, 2-257 
RECOVER-FD 2-303 
rectangular chart 2-280 
REFORMAT 2-305 
rcinitiali/.c the system 2-333 
remote 2-276 

Remote Spooling Communications Subsystem 
(RSCS) 2-320, 2-323 
rename an account 2-306 
RENAME-ACCOUNT 2-306 
RENAME-FILE 2-307 

Request To Send (RTS) 2-152 thru 2-153, 2-291 
thru 2-292, 2-309, 2-365 
RESET-LOGOFF 2-309 
restart a stopped printer 2-409 
RESTORE-ALL-ULTIS 2-310 
RESTORE-FILE 2-311 
^synchronization 2-143,2-421 
retension the tape 2-478 
retrieval lock 2-37, 2-108, 2-117, 2-121 
RETRIEVE key 2-9 
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RETURN 1-3, 1-7, 1-12 
REV 2-314 
revision level 2-314 
rewinds the tape 2-479 
RP-ATT 2-316 
RP-DET 2-318 
RP-PUNCH 2-319 
RP-READ 2-323 
RS232 control signals 2-293 
RTD 2-328 
RUN 2-329 

RUNOFF 2-330, 2-385, 2-390 
RUNPROC 2-331 


- s - 


S-DUMP 2-332 

S/1-DUMP 2-333 

S/1-LOAD 2-335 

S/370 and S/390 H1FAS 2-335 

S/AMC 2-213 

S/NAME 2-213 

sample period 2-439 

SAVE 2-336 

SAVE-LIST 2-340 

save-lists 2-131 

SAVE-PARITY 2-342 

saved select-list 2-174, 2-340 

saved-list pointers 2-99 

scatter diagram 2-280 

screen editor 2-343 

SE 2-343 

SEARCH 2-344 

sector number 2-138 

SECURITY 2-346 

SECURITY account 1-8,2-106,2-541 
security code 2-35 
security features 2-348 
Security Main Menu 2-346 
SECURITY-STATUS 2-348 
See Also 2-1 


SEL-RESTORE 2-350 
SELECT 2-353 
select-list 2-253 

separation 2-42, 2-52, 2-68, 2-107, 2-115, 2-118, 
2-120, 2-215, 2-217, 2-294, 2-296, 2-542 
scparalion.algorithm 2-117 
serial printer 2-398,2-407, 2-520 
Series/1 2-333, 2-355 
set terminal characteristics 2-502 
SET-BAUD 2-354 
SET-DATE 2-357 
SET-FILE 2-359 
SET-LANGUAGE 2-361 
SET-LEVEL-PUSH 2-362 
SET-LOGOFF 2-365 
SET-LPTR 2-366 
SET-STACK 2-367 
SET-SYM 2-369 
SET-TERM 2-370 
SET-TIME 2-375 
shadow 2-421 
shadowed disks 2-146 
shadowed system 2-139,2-146 
SHOW-LEVELS 2-376 
sib 2-139,2-421 
sibling disk 2-143 
single quotes (') I -3, 2-363 
SLEEP 2-378 
SLEEP period 2-378 
SORT 2-379 
SORT-ITEM 2-381 
SORT-LABEL 2-382 
source account 2-255 
source file 2-98 
source frame size 2-17 
source list 2-103 
source tape drive 2-463, 2-464 
SP-ASSIGN 2-383 
SP-CLOSE 2-387 
SP-DELETELPTR 2-388 
SP-DEQ 2-389 
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SP-EDIT 2-390 
SP-KILL 2-395 
SP-LISTASSIGN 2-396 
SP-LISTLPTR 2-398 
SP-LISTQ 2-400 
SP-MENU 2-403 
SP-OPEN 2-404 
SP-SKIP 2-405 
SP-STARTLPTR 2-406 
SP-STATUS 2-413 
SP-STOPLPTR 2-414 
SP-TAPEOUT 2-415 
space compression 2-529 
SPIE 2-417 
SPLOT 2-418 
spooler assignment 
for tape 2-415 
options 2-383 
SREFORMAT 2-419 
SSELECT 2-420 
stack command keys 1-11 
stack entry number 2-6, 2-550 
stacking TCL Commands 1-18 
START-RESYNC 2-421 
STAT 2-422 

STAT-FILE 2-46, 2-169, 2-188, 2-221,2-207, 
2-294, 2-336, 2-337, 2-338, 2-351 
STATUS 2-423 
Status Test 2-270 
stop a logical printer 2-414 
stop bit 2-355 
stop condition 2-247 
string delimiters 2-363 
STRIP-PARITY 2-424 
STRIP-SOURCE 2-425 
SUBD 2-426 

subroutine return-stack address 2-557 
SUBX 2-427 
SUM 2-428 

symbolic debugger file 2-369 
symbolic debugging 2-12 


syntax 2-1 
SYS-GEN 2-429 

SYS-GEN tape 2-40, 2-41,2-338, 2-534 
SYS LIB file 2-277 
SYSMON 2-430 

SYSMON.HISTORY 2-432, 2-435, 2-447 
SYSPROG account 1-8 
SYSPROG Load Ulti s menu 2-534 
SYSPROG Main Menu 2-451 
system assembly language (ABS) 2-549 
system console 2-225 
system date 2-129,2-357 
system debugger (!) 2-142, 2-183, 2-247, 2-264, 
2-493 

SYSTEM dictionary 2-106, 2-110, 2-255, 2-352 
System error messages B-l 
system error reporting and interpretation document 
2-203 

system errors 2-57 
SYSTEM file 2-336 
system file-restore 2-15 
system lock bytes 2-554 
system Master Dictionary 1-3, 2-47 
system messages 1-7 
System O vervie w x i i i 
system security 1-19 
system starting and stopping 1-19 
system status information 2-552 
system lime 2-129, 2-375, 2-519 
system upgrading 1-19 
system utilities 1-19 
SYSTEM-ERROR-SUMMARY 2-453 
SYSTEM-ERRORS 2-202 
SYSTEM-ERRORS file 2-190, 2-203, 2-269, 
2-270, 2-453,2-455 
SYSTEMERRORS 2-455 

- T - 

T-ATT 2-455 
T-BCK 2-456 
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T-CHK 2-462 

T-COPY 2-463 

T-DET 2-466 

T-DUMP 2-468 

T-EOD 2-469 

T-ERASE 2-470 

T-FWD 2-471 

T-LOAD 2-472 

T-RDLBL 2-473 

T-READ 2-475 

T-RET 2-478 

T-REW 2-479 

T-SPACE 2-480 

T-STATUS 2-481 

T-UNLOAD 2-483 

T-WEOF 2-484 

T-WTLBL 2-486 

TAB key 2-489 

tab stops 2-488 

TABS 2-488 

TAC 2-19, 2-35, 2-146 

TACPAC 2-268 

tape density 2-457 

tape drive operation and control 1-19 

tape drive test 2-267 

tape file 2-415 

tape format errors 2-208,2-547 
tape gain adjustment test 2-270 
tape label 2-473 
tape speed 2-457 
TAPE.DIAGS 2-241,2-491 
TCL 

accessing 1-2 
command stack 1-9 
displaying execute level 2-336, 2-492 
level pushing 1-13, 2-362, 2-363 
levels 2-376 

prompt 1-2,1-9,2-492,2-501 
stack 2-6, 2-92, 2-159, 2-168, 2-367, 2-550 
stack entry number 2-492 
workspaces 2-26 
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TCL-I commands 1-8 
TCL-II commands 1-8 
TCL-PROMPT 2-492 
TCL-PROMPT-OFF 2-501 
temporary access code 2-35 
temporary select-list 2-340 
TERM 2-502 
TERM-INIT 2-509 
TERM-VIEW 2-511 
TERM-VIEW-OFF 2-514 
TERM-VIEW-ON 2-515 
TERMDEF file 2-286 
TERMINAL 2-516 

terminal and line operation and control 1-20 

terminal definitions 2-223 

terminal display feature 2-272 

terminal echo feature 2-159, 2-160 

terminal parameters 2-516 

terminal session 2-242, 2-244, 2-263 

TIME 2-519 

top-of-form character sequence 2-371,2-503 

track I/O buffers 2-143 

transaction 2-225 

transaction log restore 2-16 

transaction log tape 2-15, 2-46 

transaction logger 2-225, 2-466 

transaction logger status 2-240 thru 2-241 

transaction logging tape 2-311 

transient Group Format Errors (GFEs) 2-338 

translate characters 2-520 

TRANSLATE-INPUT 2-520 

TRANSLATE-LOAD 2-525 

TRANSLATE-OFF 2-526 

TRANSLATE-ON 2-527 

translation characters 2-523 

translation sequence 2-520 

translation table 2-520, 2-525 thru 2-528 

transmission record 2-529 

TRANSMIT 2-529 

trapped process 2-242 

troubleshooting suspected hardware problems 2-453 
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TSYM file 2-172 

typeahead feature 2-274, 2-532 thru 2-533 
typeahead input buffer 2-563 
TYPEAHEAD-OFF 2-532 
TYPEAHEAD-ON 2-533 

- u - 

UDS 2-201 C/D modem 2-530 
UDS 2-208 B/D modem 2-530 
ULTI*MENU 2-534 
ULTIKIT 2-535 
UlliLink 2-113 

Ultimate 1400 system 2-57, 2-60 thru 2-61,2-93, 
2-168, 2-202, 2-203, 2-291,2-276, 2-293, 2- 
348, 2-407, 2-434, 2-441,2-444, 2-446, 2-451 
thru 2-452, 2-460, 2-464 thru 2-465, 2-473, 2- 
492 

Ultimate 1400 system cartridge tape 2-461,2-463, 
2-469, 2-483 

Ultimate Accounts Manager menu 2-346 
Ultimate Bull 6000/7000 system 2-21,2-30, 2-46, 
2-61, 2-70 thru 2-73, 2-77, 2-123, 2-131 thru 
132, 2-136 thru 2-137, 2-186, 2-252, 2-254, 
2-258, 2-275 thru 2-277, 2-293, 2-337, 2-348, 
2-439, 2-451, 2-462, 2-464 
Ultimate Bull 7000 system 2-142 thru 2-143, 
2-145,2-421,2-492 
Ultimate Bull 8Mb 6000 system 2-492 
Ultimate CRT (Volkcr-Craig) 2-373, 2-505, 2-509 
Ultimate HPP system 2-492 
Ultimate LSI system 2-479, 2-483 thru 2-484 
Ultimate Operating System xii 
Ultimate RECALL® commands 1 -1 
Ultimate S/370 and S/390 systems 2-2, 2-23 thru 
2-24, 2-49, 2-50 thru 2-51, 2-60, 2-63, 2-70, 
2-255, 2-300, 2-301, 2-305, 2-310, 2-317 thru 
2-318, 2-330, 2-388, 2-390, 2-392 thru 2-393, 
2-411, 2-438, 2-486, 2-512, 2-513, 2-532 thru 
2-533, 2-543, 2-545, 2-564, 2-566 
Ultimate ULT-50 2-373, 2-505 


Ultimate UPDATE commands 1-1 
Ultimate VDT (ADDS Viewpoint) 2-373, 2-505, 
2-509 

Ullimatc-lo-Ullimalc file transfer 2-319 
Ullimaiion 2-113 

UlliNct 2-26, 2-162, 2-169, 2-181,2-342, 2-425, 
2-523 thru 2-533, 2-553 thru 2-554 
UlliPlot 1-1,2-184, 2-262, 2-264, 2-399, 2-400 
UlliWord 2-97, 2-258, 2-270, 2-359, 2-367, 2-490, 
2-510, 2-539, 2-540, 2-560 thru 2-561 
unequal length errors 2-462 
Universal Character Set Buffer (UCSB) 2-406, 
2-410, D-l 

UNLOCK-FRAME 2-536 
UPD-DEF 2-537 
UPD-VALIDATE 2-538 
UPDATE 2-539 

definition item 2-124 thru 2-125, 2-135, 2-194, 
2-537, 2-546 

dictionary definitions 2-538 thru 2-539 
update lock 2-37, 2-109, 2-117,2-121 
update restore 2-16 
UPDATE-ACCOUNT 2-541 
UPDATE-FILE 2-542 
update-save tape 2-15,2-311 
UPG-REV 2-544 
UPG-REV.WC 2-544 
UPG-SYSPROCLIB 2-544 
UPG-ULTIS 2-544 
UPG-ULTIS.WC 2-543 
uppercase 2-415 
USER-C'OLD-START 2-545 
USORT 2-546 

Utility Sub-System 2-139,2-143 

- V - 

verb 1-3,2-220 

verify Ssavc statistics report 2-207 
verily tape 2-547 
VERIFY-SAVE 2-547 
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Index 


VERIFY-SAVE file 2-207 
VERIFY-SYSTEM 2-549 
VIEW 2-550 
virtual address 2-440 
virtual card images 2-316, 2-318,2-323 
virtual frames 2-437 
virtual lock 2-439 

virtual machine 2-320,2-323 thru 2-324 
virtual punch device 2-316,2-318 
virtual reader device 2-316,2-318 
visual attributes 2-495 
VM/VMS mode 2-375 
VSAVE-STATS 2-207, 2-547 
VT220 terminals 2-511 

- w - 

wake-up feature 2-378 
warmstart 2-30,2-185,2-424 
WHAT 2-552 
WHERE 2-556 
WHO 2-558 

wild card ( A ) character 2-345 
word processing 
WP-IN{PUT) 2-560 
WP-OUT(PUT) 2-561 
write lock 2-446 
WY60 2-562 

Wyse Wy-50 2-356, 2-486, 2-505 
Wyse WY-60 in native mode 2-356, 2-486,2-489, 
2-505, 2-509 

Wyse WY-85 2-356, 2-486, 2-489, 2-505, 2-509 

- X - 


XSYM file 2-567 thru 2-568 
XTD (Hexadecimal To Decimal) 2-570 
XTD 2-570 


X'nn' xv 
X-OFF 2-563 
X-ON 2-565 
X-REF 2-567 
XON/XOFF 2-355 
XREF 2-568 
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Problem Identification Form 


Name 

Phone Number 

System Number 

Date 


( ) 




At TCL, execute REV verb and enter the 
following information: 

Firmware rev. _ 

Kernel rev. _ 

Async rev. _ 

Abs rev. _ 

Diags rev. _ 

ECOs _ 


Hardware Platform: (manufacturer, model no.) 


Host O/S and revision 


Dealer Name 


At TCL, execute WHAT (LSWP) verb and attach listing to this report. 

Description of what happened and steps necessary to recreate (attach listings, tapes, if available): 













FROM: 


Name: ___ System Number: _ 

Company _____ 

Address: __ 

City: _ State: _ Zip: 


Fold and tape. Please do not staple. 



The Ultimate Corp. 

717 Ridgedale Avenue 
East Hanover, NJ 07936 
Attn: Technical Support 


Fold and tape. Please do not staple. 




ID 

Number 


Ultimate 

THE ULTIMATE CORP. 



Reader Comment Form 


Ultimate welcomes your comments. If you find a problem or error in this manual, or can suggest 
an improvement, please complete this form. Please attach additional sheets, if necessary. 


Name 

Phone Number 

( ) 

System Number 

Name of Manual 

Document Number 

Date 


Comments: 








FROM: 


Name: _ System Number: _ 

Company _____ 

Address: _ 

City: _____ State: _ Zip: 


Fold and tape. Please do not staple. 



The Ultimate Corp. 

717 Ridgedale Avenue 
East Hanover, NJ 07936 
Attn: Technical Support 


Fold and tape. Please do not staple. 





Ultimate welcomes your suggestions. If you have a suggestion or would like to recommend an 
enhancement, please complete this form. Please attach additional sheets, if necessary. 







FROM: 


Name: _ System Number: _ 

Company _ 

Address: _ 

City: ■ ___ State:_Zip: 


Fold and tape. Please do not staple. 


The Ultimate Corp. 

717 Ridgedale Avenue 
East Hanover, NJ 07936 
Attn: Technical Support 


Fold and tape. Please do not staple. 





( 
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